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Foreword 


There's a new computer on the market: the Commodore 128. With its 


state-of-the-art hardware it should experience the same success as the C-64. 


No manual can answer every question about a computer. We are going to 
Supplement the Commodore 128 System Guide in an attempt to answer 
some questions that book may have raised. If you want to know how you 
can get more out of BASIC 7.0, then you have the nght book in your 
hands. 


The title Peeks and Pokes gives the impression that we are going to 
concentrate on these two commands. These instructions are the best way to 
gain access to the internal operations of your C-128. However, there are 
other commands we can use. These other commands can't be used in all 


manipulations, but we'll show you where they do work. 


This book also gives you an introduction to machine language. As a matter 
of fact, you will be treated to two short courses—one for the 8502, and the 
other for the Z80. 


This book is not a complete reference guide. However, you can get a good 
grasp of the basics of C-128 machine language programming without a lot 
of effort . 


Have fun! 


Hans Joachim Liesert, Rudiger Linden 
Munster, December 1985. 
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Chapter 1 


Operation of the C-128 
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Operation of the C-128 


The following sections will acquaint you with the C-128 and its operation, 
and explain some of its technical aspects. This first chapter is an 
introduction for readers who are unfamiliar with computers. If you know 
the fundamentals already, you may wish to skip to Chapter 2. 


1.1 The Microprocessor 


First we'll start off with some fundamental information on the brain of the 
computer—the microprocessor. The microprocessor 1s an integrated circuit 
that reads specific memory locations. In other words, it knows how to reach 
a fixed number of memory "cells". The microprocessor selects these cells 
through address lines. Each address line represents one bit, or binary digit, 
and can take on the values of 0 and 1. 


Both the 8502 and the Z-80 microprocessors of the C-128 have 16 
address lines. These address lines can access up to 2*16 = 65536 memory 
locations. 


Theoretically, the C-128 microprocessor should not be able to access more 
than 65536 (abbreviated as 64K) memory cells. We know that the C-128 
comes equipped with 128K of memory—how is it possible to access 
memory beyond the 64K limit? The answer is that the C-128 has a special 
electronic control that can switch between different 64K "banks" of 
memory. 


Each memory location contains 8 bits, or one byte. To access these memory 
locations, the microprocessor has a data bus that consists of eight data lines. 
In this way the microprocessor can read from or write to a specific memory 
location. 


The microprocessor can perform only simple operations. It can add, 
subtract, perform logical operations on the data, and store and retrieve data 
to and from memory. But it can do these things at a very high speed. Using 
combinations of simple operations at very high speed, the microprocessor 
can perform very complex operations. 
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1.2 The Operating System 


Every time you read through a computer book, magazine or advertisement, 
you see terms like "Interpreter", "Operating system", or Interrupt’. This 
section explains some of these computer terms. 


The /nterpreter simply translates the BASIC instructions in a program into a 
language that the computer can understand. The C-128 can understand only 
its own special machine language. 


The BASIC interpreter resides in ROM (Read-Only Memory) chips inside 
the C-128. The interpreter reads each line of a program and converts these 
program lines into a form that the 8502 microprocessor can understand. 


If BASIC is running in direct mode, the interpreter gets the instructions 
from the keyboard buffer. This input buffer acts as a sort of delivery area. It 
constantly checks the operating system in ROM, as well as the cursor 
movement, peripherals, etc. 


BASIC and the operating system are both machine language programs that 
begin to run when the computer 1s powered up, and continue to run until 
another machine language program is called. You can call such a machine 


language program yourself by issuing the BASIC SYS command. 


The computer can only run a single program at a time. But the interpreter 
and the operating system are two programs that must both be operating at 
the same time. How does this work? 


The simplest solution for running two programs simultaneously is to 
alternate between the two. Whenever BASIC is finished with a section of 
code, the computer switches over to the operating system. For example, 
when a peripheral device is accessed, BASIC is switched off and control is 
given to the operating system. The operating system then sends the 
information to the peripheral device. The control is switched back to 
BASIC. 


There are problems with this, though. For example, the keyboard can only 
be accessed when the operating system is running. When a program is 
running, the <RUN/STOP> key should be accessible to stop the program in 
progress. To solve this problem, computer engineers developed the 
interrupt. 
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Every 1/60th of a second the processor stops the program that is running 
(whether it is a BASIC program or the operating system), then checks the 
keyboard and certain other operations. If the computer finds that the 
<RUN/STOP> key has been pressed, then the BASIC program is aborted. 
If another key has been pressed, it is stored in the keyboard buffer. You 
don't need to be concerned with this, however—the keyboard is checked 
much faster than you can type. 


But from the microprocessor perspective, the time between two interrupts 
is quite long. The clock that runs a microprocessor usually runs at 1 to 2 
mullion cycles per second. A typical machine language instruction only takes 
between 3 and 4 such cycles to execute. As you can See, a processor can 
perform thousands of instructions before it's stopped by an interrupt. After 
the keyboard interrupt, the processor continues to execute the program at the 
same location where the interrupt occurred. 


Unfortunately, these interrupts can have a side-effect. After every interrupt, 
certain locations in memory are changed. BASIC must also keep track of 
these specific memory locations. There are many BASIC commands for 
graphics and sound that are controlled by interrupts. The location of each 
interrupt routine 1s put in a control register, as a BASIC command Is given. 
A POKE in the wrong register can cause unexpected results! 


There is a short test program at the end of this section. The FOR-NEXT loop 
listed below takes 46 seconds to run in the C-64 mode. By disabling the 
interrupts (we will discuss this in a later chapter), the program runs one 
whole second faster! The higher speeds cannot be measured with BASIC 
7.0's internal clock, because the interrupt routines themselves are used in 
setting the clock. 


Before you type in the program below, try typing the POKE command from 
line 10 in direct mode (without the line number). The cursor should 
disappear, and you will observe that the keyboard is no longer being read. 
When the interrupt is turned off, only <RUN/STOP>-<RESTORE> 
continues to function (Note: this program only works in the C-64 mode): 


10 POKE 56334, PEEK (56334) and 254: 
REM INTERRUPT IS TURNED OFF 
20 FOR I = 1 to 1000: PRINT I: NEXT I 
30 POKE 56334, PEEK (56334) OR 1: 
REM INTERRUPT IS TURNED ON 
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1.3 The Interpreter 


We mentioned earlier that the BASIC interpreter is responsible for 
translating BASIC commands into machine language. It is interesting to 
examine how the interpreter really works. 


First we'll look at how the commands are interpreted. The C-128 doesn't 
store the commands in their full spelling--this would take up too much 
memory. The PRINT command alone would take 5 bytes (one byte for each 
letter). 


Usually the command words are stored in an abbreviated form called 
tokens. This means that each command 1s stored 1n a code something like 
ASCII code. Numbers and characters not part of a command are saved 
directly in ASCII. Therefore, the command PRINT I requires only two 
bytes--the first for the token for the PRINT command and the second for the 
variable name. 


The first part of the translation takes place as each program line is entered 
into memory. After the BASIC line is entered and the <RETURN3> key is 
pressed, the interpreter converts all BASIC commands into their respective 
tokens. 


The second part of the translation takes place after we enter the RUN 
command. The interpreter reads each token and then performs the needed 
work. For example, the PRINT command uses one subroutine to determine 
which variable should be displayed, and another subroutine to display that 
value on the screen. Other commands such as the arithmetic routines use 
different subroutines in ROM. 


This book will help you get a closer look at these routines. For the more 
dedicated readers, consult C-128 Internals from Abacus. It contains a ROM 
listing of the operating system and many useful machine language 
programs. 
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1.4 PEEK and POKE 


Imagine yourself in the following situation: You find a computer magazine 
with a super program to type in. You type in the entire 20K listing--and 
when you run it the word ERROR pops up, or worse yet, the computer 
simply crashes. 


If you want to find the error you must first understand how the program 
works. After studying the program for a while, you're probably ready to 
say to yourself, "What in the world are all these stupid POKE commands?! 
No normal programmer would use them!" Well, let's find out just what 
they are. 


1.4.1 POKE and PEEK 


We'll start with the POKE command. The syntax of the POKE command 1s 
quite simple: POKE address,byte. Address can range from 0 to 65535, and 
byte can contain values between O and 255. This command puts the value of 
the byte into the memory location at the address indicated. 


The POKE command can be used to do many things: filling up the monitor 
screen, setting a color, and many other things. With this command you can 
delve into the workings of the computer, as well as the operating system 
and the interpreter. 


You can also look at these locations by using PEEK. The syntax for PEEK 
is: PRINT PEEK (address) , where the address can range from Q to 
65535. It is important to note that PEEK is a function. Therefore the 
parameter must be placed within parentheses. 


Together the two commands have the unique ability to modify individual 
memory locations. Before using them, you should be aware that randomly 
modifying memory within the C-128 can cause the computer to crash. 
Therefore know your memory map! 


In the C-128 mode you have to use the BANK command to inform the PEEK 
and POKE commands which memory bank to use. 
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1.4.2 SYS and USR 


Now we come to the commands which are of particular interest to the 
machine language programmer: SYS address,and PRINT USR(x). Both 
call programs in machine language. 


The SYS command runs the machine language program at the address 
specified. When the machine language program is finished, control is 
returned to BASIC. The BANK command specifies the memory bank in 
which the machine language program is located. 


The USR function operates similarly. However, it returns additional useful 
information. The first difference lies in the syntax. USR 1s a function like 
PEEK and SIN. Therefore its parameters must be contained within 
parentheses. 


The location of the machine language routine for USR 1s specified in 
memory locations 785 and 786 (C-64 mode) or memory locations 86 and 87 
(C-128 mode).Whenever the interpreter finds a USR function call it looks at 
these "vectors" to find where the program resides. It then transfers control 
to this location. When the machine language program is finished, it returns 
control back to BASIC. 


The USR routine is useful for passing data back and forth between BASIC 
and machine languge. The value in the parentheses is returned to the 
interpreter in the floating-point accumulator (97 - 101 for the C-64, 99 - 104 
for the C-128). The floating-point accumulator is an internal register in 
which all arithmetic operations are carried out. Using the information in this 
register, you can write your own machine programs that receive and operate 
on values. At the end of the USR routine, the number in the register is 
returned to BASIC. This allows you to send data to machine language 
programs in variables (for example: A=USR (x) ). 


As a result, machine language programmers can write much faster 
functions--such as a quick sorting routine. The capabilities of the USR 
function make it extremely useful. 


Abacus Software Commodore 128 Peeks & Pokes 


1.4.33 WAIT 


We've got just one more command to look at: the mysterious WAIT 
address,X,Y command. 


This command tells the computer to halt the currently-running program for a 
period of time, then start running it again. When the computer sees a WAIT 
command it reads the byte of data located at address. It then takes that value 
and performs an XOR with the Y parameter. The XOR (shorthand for 
EXCLUSIVE-OR) is related to the boolean OR operator. The following 
table shows the results of an XOR operator: 


XOR| O | 1 
O | O | 1 
eu ab. 3 


The result of a XOR is a 1 if either bit one or bit two is a 1, but not both. 
The XOR function is available in BASIC 7.0 only in the C-128 mode. 


The result of this XOR operation 1s then ANDed with the X parameter. If the 
result is zero, the interpreter repeats the whole procedure. If the answer is 
anything other than zero the interpreter restarts the program at the point 
where it was halted. 


There 1s another form of the WAIT command. In this form the Y parameter 
is not specified. Here the interpreter waits until the result of an AND with the 
byte of data located at address and the X parameter is zero. 


1.4.4 Extended RAM commands 


Unfortunately, there is an error in early printings of the Commodore 128 
System Guide. The three commands affected are FETCH, STASH, and 
SWAP. These commands are used to transfer blocks of memory in different 
banks of memory. The third and fourth parameters must be exchanged to 
correct the error. The correct entries should look like this: 

FETCH #bytes, intsa, expsa, expsb 
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FETCH #bytes, intsa, expsa, expsb 
STASH #bytes, intsa, expsa, expsb 
SWAP #bytes, intsa, expsa, expsb 


1.4.5 BANK 


Here are a few comments about the BANK command. The table below lists 
the different parameters for each possible RAM/ROM combination. The 
interpreter uses memory location 981 as the reference byte for the bank 
command. You can use PRINT PEEK (981) to see which BANK is active. 


N Configuration 


QO BANK O 

1 BANK 1 

2 BANK 2 

3 BANK 3 

4 Internal ROM functions, BANK O and I/O region. 

5 Internal ROM functions, BANK 1 and I/O region. 

6 Internal ROM functions, BANK 2 and I/O region. 

7 Internal ROM functions, BANK 3 and I/O region. 

8 External ROM functions, BANK 0 and I/O region. 

9 External ROM functions, BANK 1 and I/O region. 
10 External ROM functions, BANK 2 and I/O region. 
I. External ROM functions, BANK 3 and [I/O region. 
12 Internal low ROM functions, high ROM, BANK 0 and I/O. 
ales External low ROM functions, high ROM, BANK 0 and J/O. 
14 BASIC-ROM, BANK 0 and Graphic generator. 
LS BASIC-ROM, BANK 0 and I/O region. 


10 


Abacus Software Commodore 128 Peeks & Pokes 
1.5 The Memory Management Unit 


Regardless of what the title of this section implies, this won't get too 
technical, but to understand some programming tricks it helps to understand 
the internal construction of the computer. 


1.5.1 The C-64 mode 


You might have wondered why Commodore says the C-128 in C-64 mode 
has 64k of RAM even though BASIC has only 38k of memory available to 
use. 


The 64 kilobytes are there--however, they cannot all be used. The 8502 
microprocessor can address 64k of memory. Therefore it can only access 
65536 different memory cells. If all this was RAM, there would be no room 
for the Zero page, ROM, the BASIC interpreter, or the operating system. 
Of the total 64 kilobytes, ROM takes up 20k, the Video RAM takes up 2k, 
and four more are taken up by the Zero Page. So what's left is the 38k we 
mentioned earlier. 


Diagram 1.5.1 shows a block diagram of the memory of the C-64. You can 
see that RAM and ROM are located next to each other and have the same 
memory locations. If you wanted to switch between RAM and ROM you 
would have to change the contents of memory location 1. This, however, is 
not possible from BASIC. If we turned off the BASIC-ROM, the processor 
couldn't find the program, and the computer would crash. 


This problem can be resolved somewhat, by using the POKE or LOAD 
commands to write to a memory location, and by using the PEEK or SAVE 
commands to examine a location. A POKE to a memory location in ROM 


will alter the same location in RAM, but a PEEK to a location in ROM will 
return the value from ROM. 


The 4K in the upper third of RAM 1s at 49152 to 53247 is free memory. 


This area is for machine language programming, and can be accessed using 
the BASIC commands of PEEK and POKE. 
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Finally we come to the I/O (Input/ Output) region of memory. This is where 
the ports for the keyboard, the monitor, and the sound-generator are found. 

The computer writes data to this area of memory where it is converted to a 
video signal, a sound, or magnetic impulses which are saved on a floppy 
disk. This is also the area where the keyboard or any other input device 
writes its data and where the color RAM 1s located. 


As the block diagram shows, the I/O memory is one of three sections of 
memory. If we change location 53280, we change the frame color. 
However, that byte doesn't lie in RAM--it stays in an I/O register. This 1s 
also true for the color RAM. 


There are a total of four I/O regions in the C-64 mode. Two of these are the 
VIC (where the graphics and the monitor are managed), and the SID (the 
sound generator). There are also two CIA's (Complex Interface Adapters), 
for the keyboard and other interfaces--such as the USER-PORT. 


1.5.2 The C-128 mode 


Diagram 1.5.2 illustrates the layout of the C-128's memory. You can see 
that the memory is divided into banks of 64k. Remember, the 
microprocessors can only address 64k at a time. In order to access all of the 
memory available the processor uses the MMU (Memory Management 
Unit). The MMU switches between the appropriate banks as needed. The 
I/O region is also under the supervision of the MMU. While you're in the 
C-64 mode, the VDC (the 80-column video controller) and some control 
registers are still managed by the MMU. The MMU also controls which 
processor 1S active. The two microprocessors can be switched back and 
forth, just by changing a certain register in the MMU. 


The I/O region of the C-64, however, cannot be changed. For more 


information on the MMU in both C-64 and C-128 modes see C-128 Tricks 
& Tips from Abacus. 
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1.5.3 The CP/M mode 


When you are in CP/M mode, only 59K of memory is available for 
programming. This memory, plus some system routines, is stored in BANK 
1. BANK 0 contains the BIOS (Binary Input Output System routines), it is 
located in addresses $0000 - $D000. The MMU can access all of these 
locations. 


All of the CP/M routines are in BANK 0. These routines, together with the 
programs in user memory, can communicate with the upper end of the 
addresses, which is established as a common block. Moreover, a CP/M 
program can use the MMU to access RAM and ROM as necessary. 
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The Zero page 


2.1 The Zero page is greater than 0 


If you look at the Appendix in the Commodore 128 System Guide, the 
section on the Zero page looks menacing, but it contains a wealth of 
programming tricks and possibilities 1f you know where to look. 


The name of the Zero page is not entirely correct. The first 256 bytes of 
microprocessor memory is called the Zero page. In the C-64 mode this is 
the first kilobyte, or four pages of memory. In the C-128 mode it is the first 
four kilobytes, or 16 pages of memory. The operating system and the 
interpreter use registers in this area to keep track of the state of programs, 
numbers or codes. The first 256 bytes are useful for quickly getting data out 
of memory, since they can be accessed by a single byte. This is why we 
will usually store our data in this region. 


Many registers in the Zero page must contain certain values so that the 
computer functions properly. There are other registers which can be used 
for any purpose. 


In the C-128 mode the first four kilobytes are reserved for the internal data 
used by the BASIC interpreter and the operating system. 
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2.2 Pointers & stacks 


Two structures which we will use from now on are the pointer and the 
stack. 


A pointer, also known as a vector, points to specific locations in memory. 
They can point to either information or subroutines. For example, the cursor 
pointer always contains information about where the cursor is located on the 
screen, plus the code of the character at this location. Pointers to 
subroutines extend the use of the interpreter. Other vectors point to the 
character output routines. This means that it's possible to write machine 
language routines that change the PRINT command so that whatever shows 
on the screen 1s also sent to a printer. 


Pointers have a specific format. They are always two bytes long. The first is 
called the lowbyte, and the second, the highbyte. To find the memory 
location the pointer 1s referring to, use the following formula: 


ADDRESS = LOWBYTE + 256 * HIGHBYTE 
It is standard for the lowbyte to appear before the highbyte in memory. 


A one-byte pointer 1s an offset to a region in memory, between locations 0 
and 255, and is added to a base address. 


In C-128 mode the pointer must also contain information about the memory 
bank to be accessed. Only 64K of memory can be addressed at one time in 
any bank. 


A stack is used to temporarily store data in memory and return it in reverse 
order when it is used. You can only get information from, or put 
information on, the top item of the stack. (See Diagram 2.2). Stacks are 
widely used for implementing subroutines. When a subroutine is called the 
return address is pushed onto the stack, and when a RETURN 1s reached the 
computer gets the return address from the top of the stack and continues 
execution from this address. 
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1000 GOSUB 2000 


2000 GOSUB 3000 -__ > 


3010 RETURN 


2010 RETURN 





Diagram 2.2 
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Look at Diagram 2.2. When the interpreter receives a GOSUB command the 
line number of the GOSUB command is stored on top of the stack. Later, 


when the RETURN command 1s reached the interpreter pulls the line number 
back from the top of the stack. 


The C-128 also has stacks for the interpreter, for variables, as well as other 
stacks that should never be changed by the user. These include: 


¢ the Processor Stack (256-511) for machine language programs. 
¢ a Stack for BASIC subroutines 
ea Stack for FOR-NEXT loop 


Now we will start with some applications. In the next sections you will find 
many interesting tricks that can help you program your C-128. 


SUMMARY OF POINTERS 


ADDRESS 


LOWBYTXE+256*HIGHBYTE 


LOWBYTE = ADDRESS-INT (ADDRESS/256) *256 
HIGHBYTE= INT(ADDRESS/256) 


Pointers usually consist of two bytes that are always in the order 
of LOW/HIGH. 


In the C-128 mode you will also have to instruct the MMU to 
access a particular BANK. 
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Memory 


3.1 The memory map 


In the Appendix you will find the memory map for the C-64 and the C-128. 
Next to the Zero page is the I/O region. There are several things you should 
notice in the Zero page listing in the Commodore 128 System Guide. For 
instance, the first 5 bytes of the supposedly usable region of 673 through 
767 are reserved in the C-64 mode for the CIA. It also pays to be very 
careful when using Zero page for storing data. A misplaced POKE can 
confuse or crash the interpreter. 


Try experimenting with the Zero page. Many tricks are discovered by 


accident, and as far as we know, there is no POKE combination that could 
destroy your computer. 
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3.2 How does bank switching work? 


Bank switching is much more complicated than the BANK command leads 
you to believe. For one thing, ROM does not lie where we think it does. 


3.2.1 The MMU configuration register 


The Commodore 128 System Guide, states that the memory can be 
expanded up to 1 Megabyte. If you divide 1Mb into 64K sections, you get 
16 different memory banks. In this case, the addressing capacity of the 
MMU has been all used up. There is no more room for things like ROM's 
and I/O regions. 


Consequently, the C-128 was designed 1n much the same way as the C-64. 
ROM isn't accessed in its own memory bank. Rather, a command is 
reflected through every bank. It can be found at address D500 
(hexadecimal) as well as under FFOO in every bank. Referencing either area 
is identical. It is necessary to point out that the D500 address is in the I/O 
region, and so it can be overwritten. In this case you can use the region at 
FFOO as an extended I/O region. This region is not overwritten. 


The configuration register (CR) has many purposes. It controls every bit in 
the memory banks. The zero-bit takes care of the I/O region from D000 
through DFFF, which is also used for switching banks. Only the zero-bit 
has to be set to access the zero bank. If it 1s set to 1, the processor accesses 
ROM or RAM in the region from DOOO-DFFF. The rules for setting the bits 


of the configuration register follow. 


Bit one is used for addressing the region of memory from 4000-7FFF. If it 
is a zero, the MMU accesses the region containing the BASIC-ROM LOW 
(This is the lower region of BASIC). If bit 1 1s set to 1 then you can access 
the RAM region of the same address. 


The next section (8000 through BFFF) uses two bits together--namely bits 
3 and 2. If the combination is 00, then BASIC-ROM HIGH 1s accessed. 
The combination 11 switches over to the RAM at the same address. The 
other combinations are for different areas of ROM. O1 is for the internal 
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ROM functions. A ROM function is for a particular ROM chip, which may 
be placed in an unused socket in the C-128 circuit board. This ROM chip 
could contain things like a word processing program. There are also 
external ROM functions. It 1s quite easy to access an external module—just 
access configuration register Bits 3 and 2 with a 10. 


Bits 5 and 4 are used similarly, but they access the region of memory 
between COOQO-FFFF. This section is used to access things like the 
operating system ROM (use a combination similar to bits 3 and 2). 


All that remain are bits 7 and 6. These are used only to access the different 
memory banks. In your C-128 only two banks exist, so the 7th bit 1s 
useless. Bit-6 determines which RAM bank 1s used. 


This does not cover all the possibilities for the MMU. Here is a summary 
where all the banks are defined and much more: 


SUMMARY OF THE CONFIGURATION REGISTER 


Addresses: D500 or FFOO 
Bit O turns on the I/O region whenever it is set to 0. 


Bit 1 turns on the ROM for locations 4000-7FFF when it is set 
to O. 


Bits 2 and 3 are for locations 8000-BFFF. 
Combination: 
00 = ROM 
O1 = Internal ROM functions 
10 = ROM modules 
11 =RAM 


Bits 5 and 4 work in the same manner except for locations 


Bit 6 determines which memory bank to use. 
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3.2.2 The pre-configuration mechanism 


It's a slow and complicated process to switch banks every time you want to 
load the contents of the configuration register. There must be a way to 
switch quickly in the MMU. We must know which memory configurations 
we'll be using in our program to do this. Up to four such configurations can 
be stored in the pre-configuration PCR registers (memory locations 
D501-D504). These registers are always available. As soon as one of the 
loading registers LCR (memory locations FFOQ1-FFO4) has a word written 
to it, the MMU will independently switch it with the appropriate word in the 
PCR in the configuration register. This method 1s much quicker than the 
processor could do it. 


3.2.3 The Mode Configuration Register 


As its name suggests, the MCR (address D505) controls the modes of the 
computer. We will discuss only two bits of the MCR in this section. 


The 0-bit controls which processor 1s active: 


The 6-bit controls the mode in which the computer will run: 


1: the C-64 mode 
QO: the C-128 mode 


There is a problem with this method, though. Every time we try to change 
the mode using a POKE, the computer locks up. The only way to change the 
mode of the computer without causing a crash is with a machine language 
program. Several operating system routines can be used for this purpose. 
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3.2.4 The RAM-configuration register 


Now we come to an outstanding capability of the MMU. It establishes in 
RAM a common area for all of the memory banks. A specific area in 
memory for the high or low ends of the address range is not needed because 
they are all the same size. This is important, because the different regions of 
memory can exchange data with each other. These regions, and more, are 
controlled by the RAM configuration register (D506). The size of the 
common region of memory 1s held in the first two bits. Here is a table: 


BITS 1 0 | Size in K 
00 | uy 
OF a. iff 4 
10 | 8 
11 | 16 


The second and third bytes determine where this common region is located. 
If the bits are 00, there is no common region of memory. If they are 01 this 
region is in the lower portion of memory starting at OOOO. If they are 10, it 
is in the upper end of memory. The combination 11 has one half in low 
memory and the other in high memory. 


The fourth and fifth bits are not used, just like bit 7. The sixth bit 
determines in which RAM bank the VIC chip looks for its data. 


SUMMARY OF THE RAM-CONFIGURATION 
REGISTER 


BITS 1 and O determine the size of the common region. 
BITS 2 and 3 determine if and/or where the region 1s located. 


BIT 6 determines in which Bank the VIC chip finds its information. 
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3.2.5 Memory page pointer & version register 


These registers have very specialized tasks. The memory page pointer 
allows you to switch the Zero page and the stack into the another region of 
memory. All you have to worry about are the small glitches in the machine 
language. 


The version register helps commercial software applications determine in 
which version of the C-128 the program is running. In this way, an 
eventual change in the machine structure can be accounted for in future 
programs. 


3.2.6 Memory configurations for the interpreter 


BASIC 7.0 constantly uses the pre-configuration register mechanism. Four 
standard configurations are stored, and either bank O or bank 1 is switched. 
Just two of these combinations take up the entire ROM. There is also a 
common region of memory (1K) at the low end of memory. 


If an interpreter command is encountered, there are two possibile 
consequences. In the direct mode, the command is passed through the 
keyboard buffer (this is where the computer stores everything that we type). 
The keyboard buffer lies in a common region of memory, reserved for 
every configuration. After this is finished, the ROM 1s turned on and the 
command 1s turned off. 


If the interpreter command comes directly from program memory, a 
Subroutine in the common region of memory copies the command from 
program memory into the low end of memory. Here the interpreter converts 
the command into the appropriate machine language equivalent. 


Many commands require information from a different bank of memory. For 
example, variable memory uses a special subroutine to fetch the data from 
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The BASIC commands PEEK and POKE are designed so that they cannot 
alter the memory configuration. For this reason, you must use machine 
language routines if you want to access information from the character 
generator, for example. 


3.2.7 Bank switching in the C-64 mode 


In the C-64 mode everything is a lot easier. Byte 1 controls the partitioning 
of memory, and only bits 0 through 2 have any control. Normally all three 
bits are set to 1. If any of the bits are set to 0, then memory partitioning is 
altered. 


If bit 0 1s set to zero then the BASIC-ROM (40960 - 49151) is turned off. If 
bit 1 1s a zero, then both BASIC and the operating system are turned off. If 
both bits 0 and 1 are set to zero, then the I/O region 1s also turned off. That 
leaves 62K for I/O use (video RAM and the Zero page are not overwritten). 
Bit 2 determines whether or not the character generator can be read 
(remember the triple assignment). 


Unfortunately, this arrangement causes problems. If we turn off BASIC 
and the operating system, the machine locks up. Therefore, only a machine 
language program can change these bits. 


There is something else which affects the character generator. The C-64 will 
lock up if bit 2 is set to zero. It won't be able to access the I/O region. The 
interrupt routines will continuously monitor the keyboard. At this point it 
would be helpful if we understood the interrupts (See Section 1.2). 
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SUMMARY OF THE MEMORY LAYOUT FOR THE C-64 


The memory layout is controlled by the first byte in memory (Byte 1). 


Bits 0-2 are set to one in normal operation. By turning off 
specific bits you can change the memory 
configuration. 

Bit 0 turns off the BASIC-ROM. 

Bit 1 turns off both BASIC and the operating system at 
the same time. 

Bits O & 1 turns off the I/O region along with the 
BASIC-ROM and the operating system. 

Bit 2 is responsible for the output of the character 
generator. 


Turning off any of these interrupts from BASIC is not possible. 
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3.3. Memory protection 


The architecture of the C-128 is designed to provide a large amount of 
memory for BASIC. As it is, the BASIC interpreter itself occupies a lot of 
memory. For example, to implement a second graphics page, you might 
want to protect this area from inadvertent destruction by the BASIC 
commands. 


We can do this in several ways: 


The beginning of a BASIC program resides at either location 7168 or 16384 
of memory. BASIC storage 1s divided into two banks. 


The Zero page contains a pointer to both the beginning and ending address 
of program storage. If we want to relocate the beginning of program storage 


to 20000, we set the Zero page pointers at memory locations 43/44 (for the 
C-64) or 45/46 (in the C-128) as follows: 


POKE 46, (2000041)/256 
POKE 45, (20000+1)-PEEK (46) *256 


Issue these commands in the above order, since the second POKE depends 
on the first. Don't forget to add 1 to the starting address 20000. The first 
byte of program storage must be set to a zero. 

POKE 200007. °0 


If you are using the C-128 mode, you're done! 


If you are using the C-64 mode, you have an extra step. You must issue a 
NEW command to reset the additional pointers. A CLR is not enough! 


So we have changed the pointers to the start of BASIC program storage 
with these POKEs. However, the program text itself is not relocated. 


One command does relocate program text--the GRAPHIC command. This 
moves the current program text from 7168 to 16384. 
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If you change the start of BASIC program storage pointers manually, any 
program in memory is lost unless you first relocate it to the new program 
storage area. To preserve the program you must either retype it or load a 
copy of the program to the new program storage area (as described below). 


In the C-128, you can relocate the variable storage area by one of two 
methods. 


First, you can set the pointers at 47/48 to the start of the new variable 
storage areain BANK 1. 


Second, you can set the pointers at 4626/4627 to the end of the program 
Storage area in BANK 0. 


In either case, you must also issue either a CLR or NEW command to reset 
the other pointers. These changes must be performed in direct mode before 
a program is entered. Alternatively you can use the following short program 
to set the pointers and load your program: 


10 POKE 43, (2560+1) -INT(2561/256) *256 

20 POKE 44, (2560+1)/256:POKE 2560, O 

30 LOAD "MAINPROGRAM", 8 

40 REM <RUNSTOP> <RESTORE> NOW RESETS COMPUTER 


Unfortunately, this doesn't work in the C-64 mode which still requires a 
NEW command. For this reason it cannot be loaded. Without these 
commands you cannot change the pointers. We can use the following steps 
instead: 


. Protect memory in the direct mode (like above). 

. Load a program 

. Start the program, and run it so all of the variables are used at least 
once. 

View all of the pointers using the following commands: 


> (Whore 


PRINT PEEK(43), PEEK (44) 
PRINT PEEK(45), PEEK (46) 
PRINT PEEK(47), PEEK (48) 
PRINT PEEK(49), PEEK(50) 


5. Set the pointers using the following program: 
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1 POKE 43,PEEK (43) :POKE 44,PEEK(44): POKE address, 0 

2 POKE 45,PEEK(45):POKE 46,PEEK(46): POKE 47, 
PEEK (47) :POKE 48,PEEK(48): POKE 49, PEEK (49): 
POKE 50,PEEK(50) 

3 CLR: LOAD "program" 


Where address is the starting point of the BASIC program. This loads a 
runnable program. 


In the following sections, you need only to learn the topic of the section. 
We will take care of protecting your memory for you. 


SUMMARY OF MEMORY PROTECTION 
Setting the start of BASIC: 


C-128:POKE 45,LOW:POKE 46,HIGH:POKE address, 0 
C-64:POKE43,LOW:POKE 44,HIGH:POKE address,0:NEW 


BASIC Variable end setting 


C-128: POKE 57,LOW: POKE 58,HIGH: CLR 
C-64: POKE 55,LOW: POKE 56,HIGH: CLR 


Additional possibilities for the C-128: 


Variable storage beginning (47/48) on top,and program end 
(4626/4627) on the bottom. 
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The FRE() function returns an integer word. Integer variables in BASIC 
have a range from -32767 to +32767. The interpreter must use numbers 
greater than 32767, so it uses negative numbers. You can find the number 
of free bytes in C-64 mode by using the command PRINT 
6553 87P RE (0)« 


You may want to get rid of some data that you have sent to a machine 
language program, or you don't want to use an entire variable for a single 
byte, or even a single bit. Only the CLR command deletes all of the variables 
in a program. 


Find some free memory in the Zero page to POKE your data into. A NEW or 
CLR command wont clear this page. Below 1s a list of free memory. 


UNUSED AREAS IN C-128 MODE: 


251 - 254 

996 - 1007 

OZ Ls - O23 

2816- 3072 Overwritten by cassette commands or a 
BOOT. 

3072- 3583 Overwntten by any RS-232 command. 

3584- 4095 — use only if no sprites are used. 

4864- 6143 


6144- 7167 Reserved for function keys 


UNUSED AREAS IN C-64 MODE: 


251 = 254 Could eventually change 


678 - 767 

780 - 783 Use only if SYS 1s not used. 

820 - 827 

828 - 1019 Overwritten by any cassette commands. 
1020 - 1023 

2024 - 2039 


49152 - 53247 
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External storage and peripherals 


4.1 Retrieving data for graphics, monitor output, etc. 


The C-128 can display graphics of all types. All of these graphics must be 
retrieved from memory at some point. This process is simplified on the 
C-128 by using the BSAVE command. The address of video RAM is 
discussed in a later section. 


In C-64 mode, displaying graphics is not quite so simple. However, there 
are some helpful routines. The first program of this chapter 1s one that saves 
a certain region of memory onto a cassette. 


Once again we can use the pointers in the Zero page to help. The pointers 
and registers for data management are located in the region from between 
170-1995. 


The most important pointers are those that point to the beginning and end of 
the memory range to be saved. The pointer to the beginning is found in 
locations 193 and 194. The pointer to the end is found in locations 174 and 
175. The SAVE command can be called using the command SYS 62954. 
We must also enter a filename before we can save it. An easy way to do this 
is to put a REM line in the first program line containing the file name. The 
address of the program name 1s then set by the operating system in locations 
187 and 188. 


Now welll discuss secondary addressing, device numbers, and the length 
of filenames. Take a look at this program: 
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10 REM filename 

20 POKE 193,SL: POKE 194,SH: 
REM starting address (low/high) 

30 -POKE. 174, EL? “POKE. 1.75, EH 
REM ending address (low/high) 

40 POKE 187, PEEK(43)+6: POKE 188, PEEK(44): 
REM points to filename 

50 POKE 183,L: REM filename length 

60 POKE 186,1: POKE 185,0: REM device/secondary 
address 

70 SYS 62954: REM call the save routine in ROM 


A note about line 40. The operating system keeps the vector to the filename 
in Zero page at 187/188. Since we're using the filename in the REM 
statement in line 10, this vector will point to the start of program storage + 
6. If the result of PEEK (43) +6 1s greater than 255, then the computer will 
give an ILLEGAL-QUANTITY-ERROR. If this happens you should 
calculate the address using the formula PEEK (43) +6+PEEK (44) *256. 


You can also write data to diskette. Use PRINT#1, CHRS (x). This sends 
an ASCII character to the diskette. 


To use this command, you must understand a little about how information is 
stored on a floppy. Every program on the diskette has an identifying entry 
in the directory, in addition to the program text. At the start of the text are 
two bytes that contain the starting address for the loading point of the 
program. Normally, these are O and 8 (0+256*8=2048=Start-of-BASIC). 
The text is saved byte by byte in tokenized form. Basically, the interpreter 
codes are similar to an ASCII code for the disk drive. If you need to read a 
pointer with the contents in locations in bytes 65 and 66, you can do this by 
using the following command: 


GET #1, AS,BS 
where A and B are both string variables. 
We can write a character to the diskette using the BASIC command: 


PRINT #1, CHRS (X) 
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If we had used PRINT #1,X, then X would be saved as more than one 
byte (1 byte for each character). You should follow these steps when saving 
a program using this technique: 


1. Make a directory entry by using the OPEN statement 
2. Write the starting address to the diskette: 
Use the following formula: 
PRINT #1, CHRS(lowbyte);: 
PRINT #1, CHRS(highbyte),;: 
3. Write the program text to diskette 


The text can even be a machine language program, which 1s saved byte by 
byte. Here is a program that saves the screen image located at $0400 to 
diskette: 


10 OPEN 1,8,1, "QO: IMAGE" 
20 PRINT #1, CHRS(0);: 
PRINT #1, CHRS(4);: 
REM Starting point 
30 FOR I= 1024 to 2023 
40 PRINT #1, CHRS$(PEEK(I)); 
50° (-NEXT 2% “CLOSE: 1 


You can reload the program or screen image using either of these 
commands: 
LOAD "IMAGE",8,1 
(or) BLOAD "image" 


The secondary address 1 (part of the OPEN statement) 1s very important. It 
tells DOS (Disk Operating System) that we want to save a program to 
diskette. 


Warning: Do not omit the CLOSE statement at the end of the program. If 
you do, your program will not be saved correctly. 


You can use this method for exchanging data between the C-64 and the 
C-128. 
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4.2 Merging programs by hand 


Now we come to a common problem. Perhaps you have parts of programs 
that are saved, tested, and would work very well together, but you don't 
want to have to retype these program parts to use in new programs. At 
times like these it would be nice to have a MERGE command to combine two 
programs together. You can use the following technique to do this. 


What we want to do 1s to append one program at the end of another. It 
would be nice if we could tell the interpreter where in memory we want to 
load the second section of code. We just have to worry about overwriting 
the old program. 


If the program memory is protected, we can simply LOAD the program to 
free up the protected memory. The second program must have larger line 
numbers than the first. Otherwise, the interpreter will write over the old 
lines anyway. 


Here are the steps required to merge two programs: 
1. PRINT PEEK (45),PEEK(46) (C-64: 43/44) 


This prints the contents of the pointers to the start of program storage 
(normally, this would be between 1 and 28 for the 128, and 1 and 8 
in C-64 mode). We should jot these down somewhere so that we can 
restore the configuration of the original program later. 


2. POKE 46, (PEEK(4624) + 256 * PEEK(4625) - 2)/ 256 
( C-64: 44/45/46 ) 
POKE 45, (PEEK(4624) + 256 * PEEK(4625) - 2) 
—-PEEK (46) *256 ( C-64: 43/45/46/44 ) 


The pointer to beginning of the variable storage 1s in locations 47 and 
48 (45 and 46 in C-64). The end of the program is two bytes before 
this value. Remember that the program is in BANK 0O and the 
variables are in BANK 1. The pointer 4624/4625 points to the end of 
the program in C-128 mode. 


The two POKE commands adjust the program starting address to a 


point beyond the original program text to protect it from being 
overwritten. 
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3. NEW 


This initializes the pointers to the new variables and line numbers 
which will be used in the resulting program. 


4. DLOAD or LOAD 


Now we just LOAD the new program into memory. You cannot use 
the command LOAD "Name", X,1 or BLOAD; this would put the 
address of the new program right on top of the old one, thereby 
overwriting it. 


5. POKE 45,originalvalueA: POKE 46, original value B (43/44) 


Here we return to the original memory configuration. Both programs 
are dependent on each other. 


There is a second method in the C-128 mode. In order to use this 
method the MERGE command must have an additional line in the 
target program, forexample:0 REM 


Now, use the command: 
BLOAD "name", ON B 0, P address 


to load the combined program after the old one. Replace address 
with the formula: 


PRINT PEEK (4624)+ 256 * PEEK(4625) - 2 


After the BLOAD command the pointers to the combined program are 
not yet correct. A LISTing will produce confusing gibberish. If we 
delete line 0, BASIC is forced to recalculate all the pointers to the 
program text. The program is now completely merged. Warning: 
Make sure that the programs do not contain the same line numbers. 
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She ate 


SUMMARY OF MERGING BY HAND 


PRINT PEEK(45), PEEK(46): 
REM PEEK(45) original value A 
PEEK (46) original value B 
POKE 46, (PEEK (4624) +256*PEEK (4625) - 
2) 256 
POKE 45, (PEEK (4624) +256*PEEK (4625) - 2) - 
PEEK (46) *256 
NEW 
LOAD 
POKE 45,original value A 
POKE 46,o0riginal value B 


Second method for the C-128: 


ie 
Z. 


> 


Put a dummy line 0 1n your program 

BLOAD "name", ON B 0O,P address 

where address= PEEK (4624) +256*PEEK (4625) -2 
Remove dummy line 0 from program. 
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4.3 Program files 


As mentioned in section 4.1, the first two bytes in a PRG-file contain the 
beginning address of the program. You can display these pointers with the 
following program: 


10 OPEN 1,8,8,"name,p,r" 

20 GET #1,AS: GET #1,BS$ 

30 AD=ASC (AS+CHRS (0)) + 256*ASC (BS$S+CHRS (0) ) 
40 PRINT "starting address"; AD 

50. CLOSE: 1 


The directory is also a program file. You can display the directory by typing 


OPEN 1,8,8,"S,p,r". Using GET #1, you can read the directory 
byte by byte. 
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The 40-column screen 


We are going to discuss the normal setup and manipulation of the 
40-column screen. You will discover that you don't have to use high 
resolution graphics to produce good looking pictures. 


5.1 Bar graphs 


Bar graphs can display quite a bit of information at a glance. For instance, 
you might create a graph to show sales for each month of the year. 
Unfortunately, the BOX command for the C-128 is mediocre at best. The 
program below makes bar graphs much easier to produce. You can use this 
as a Subroutine in one of your programs. Just set the parameters for the 
subroutine in your program and type GOSUB 60500. 


You can use graphic characters to make some impressive bar graphs. We 
can display 320 pixels horizontally, which is 40 characters (each character is 
8 pixels wide). 


For each line of the graph, we must calculate how many characters we need 
in reverse video and how many we need to fill in the rest of the line. The 
easiest way to do this is to set up an array. Here is the listing for the 
subroutine: 


Need 


Sram bar oraph 3, 1 

13 dimea#t C7 storis=a@to/7ireadsnakt ci) anes t 

LS geeanmtohedk C147) 

Oe OP eae ges le ge ge ao om cg hie ae. 
CRVS COF FRU SY CRYVS) COFFS UU ERYVSE CORFE 


SQ ys _oeMaxeieved se@= 

mee Gosub 605g 

med yweee@dsex=4eyvel soe@ee 

24 gosubogadd: end 

QS ye Sede ver ane "sy tyoymtheny=ym 
48510 xaey/teqeri nt (xalaxy= (x arqg) #3 


449528 régedthenfari=Dbtoqseante and CRVisd OOo 
"erent 
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6Gh30 an#ean#+x ak (uy) 
644840 cl=peek (235) sck=peek (226) seterele C1) 
64550 calor S,c@rcharl,v zx ,an#t 


60560 color S,cS3sichar d,ce,cl,rreaturn 


A note about line 20. The commands in brackets represent the keystrokes of 
the characters. For example, {CMG} means to press the <C=> key and "G" 
at the same time. 


The characters used in the program are loaded in the first few lines. You 
may wish to use the ASCII codes for the characters just to be on the safe 
side: 


327 Loo, LOO; oly. Lol, 262, L707. Lo7 


You call this routine with GOSUB 60500. Store the length of the bars 
(1-320) in variable y. Store the line number at which the bar 1s drawn on the 
screen in variable X (0-24). The code for the color of the bar is stored in 
CO. The location of where the bar should stop is stored in variable V. Line 
60500 calculates the length of the bar and resets ANS. Line 60510 calculates 
the number of characters needed to fill in the length of the bar (G), and the 
number of characters needed to fill in the rest of the line (XA). Line 60520 
stores all the characters in the ANS string. Line 60530 fills in the rest of the 
ANS string. 


To preserve the normal PRINT command we save the current cursor 
position as well as the color (C1, C2, C3--line 60540). Then we set the 
cursor to its new location and new color (CO), and draw the bar. The last 
line puts the cursor back and returns the subroutine to the main program. 


You can uSe this routine for many applications, just remember to stay in 
lower-case mode. 
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5.2 Types of operations in character mode 


This section answers the question of where the upper- and lowercase 
characters come from. Let's say that the number 1 1s stored in video RAM 
in location 1024. This means the letter A would appear at tiie current screen 
location. The form of the character is determined (for A as well as for every 
character) by the character ROM. The character ROM occupies memory 
from 53248 through 57343. 


Each character image takes up 8 bytes in the character ROM. This creates 
the character matrix of 8x8 pixels. Each line of pixels is one byte. Each 
pixel 1s represented by one bit. If the bit is set to a 1, then the pixel 1s turned 
on to the color in the corresponding color RAM. If the bit is a O, then the 
pixel in the matrix is the color of the background color. To display the 
matrix for a character, you can enter the screen code (not ASCII code) for 
the character and enter it into the following program: 


5 BANK 14 

LO INPUT “Character code: "sc 
20 AD= 53248 + C * 8 
30 FOR I= 0 TO 7 
40 W=PEEK (AD+TI) 
50 FOR J=7 to O STEP -1 

60 IF (W AND 2 * J) THEN 

PRINT "483s “BLUSE PRINT > 
70 NEXT J: PRINT: NEXT I 
80 PRINT "PRESS RETURN": GETKEY AS: GOTO 5 


This program allows you to display the bit pattern of the character in 
uppercase. If you want to see the character in lowercase change the base 
address (AD) in line 20 from 53248 to 55296, or add 256 to the screen code 
(example: C=1+256 = 257). 


If the bit in variable Wis al the resultof (W AND 2 * n)isal,anda 
"*" is printed. Otherwise the IF statement is false and a" ." is printed. 


As the title of the section indicates, the purpose of this section 1s to discuss 


all the modes of the VIC. However, the new modes are not directly 
supported by BASIC 7.0. 
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The EXTENDED-COLOR-MODE is similar to the normal text mode. The 
bits of the character pattern that are set to 1 are seen as a pixel in the 
foreground color. The color of the 0 bits can be different. They are set to the 
background color, 0-3 in locations 53281 - 53284. 


The two high bits of the screen codes in the video RAM determine which of 
the 4 colors the O bit is set to. Consider these bits as individual numbers 
(number=Bit 7 *2 + Bit 6). This formula gives the number of the register 
(e.g. 1 O= 1*2+0=2). 


These two bits are nothing more than pointers to a position in the character 
generator. Therefore, only six bits are needed and only the first 2%6 = 64 
characters can be accessed. 


The extended-color-mode can be turned on using: 
PORE S38265;: PEEK (53265) OR ‘64 

and can be turned off using: 

PORE O32 057 PEEKS 3260) AND: 191. 


The MULTI-COLOR-MODE, although somewhat more complicated, can 
resuit in some very nice output. 


Recall that every screen character can only have as many as two different 
colors: the character color (from the color RAM) and the background color 
(from the VIC registers). Multi-color-mode, however, allows up to 4 colors 
for each character. This is possible because of a simplification of the pixel 
matrix. 


The color RAM is responsible for the color byte. If bit 3 1s not set (byte 
AND (2 * 3)=0), then everything remains as it was. Unfortunately, you 
can only use colors O through 7. You can use more colors, however, if bit 3 
is Set (the multi-color-flag). 


If bit 3 is set to a 1, we are finally in the multi-colored mode. The normal 
8x8 matrix is divided into two 4x8 matrices. Every two bits in the character 
generator are now tied to a single pixel. If both bits are set to 0 the color is 
set to the background color. If both bits are set to 1 the VIC gets the color 
from the color RAM. The other two possibilities (01 and 10) retrieve the 
color from the extended-color mode background color register. You can 
turn this mode on from BASIC using: 
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POKE: 5952/0; PEER (93270) OR: 16 


You can turn this mode off again with: 
POKE 53270,PEEK(53270) AND 239 


We run into a problem when we try to mix both graphics and text modes. 
These modes cannot be set using VIC, they can be set only with the 
operating system and then only by using some tricks. The VIC reports to 
the processor each time a graphic character is produced on the screen (this 
happens about 25 times every second). When this happens, the running 
program is interrupted long enough to switch from the graphics mode to the 
text mode. Since the processor is much faster than the VIC, any character 
can be placed on the screen. This has the effect of a mixed mode. In 
actuality, there are two modes which are being switched very rapidly. 


This technique requires that the processor always has control of certain bits 
in the VIC. We can switch to the multicolor-text mode using the POKE 
command, which will at the latest 1/30th of a second change to the new 
mode. With the POKE command you can switch modes without a machine 
Janguage program, but only in the C-64 mode. Such a machine program 
would be very short, and would require the numbers 120 and 96, using: 


POKE 4864,120 : POKE 4865,96 : SYS 4864 


This will turn off the interrupt which is responsible for graphics modes. 
There are some disadvantages to this, for the cursor disappears and the 
keyboard is no longer polled. This tnck can be used for the multicolor-text 
mode if you just want to display some information (e.g.: Menus, pictures, 
etc.). To exit this mode use the following command: 


BANK 15: SYS 27438 


As long as the interrupt 1s off you can POKE around in the VIC without the 
operating system detecting any errors. Here is an example: 


10 POKE 4864,120:POKE 4865,96:SYS 4864 
20 POKE 53270, PEEK(53270) OR 16 

25 FOR I = 1 TO 1000: NEXT 

30 BANK 15:SYS 27438 
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As you can see the characters in this mode are very messy. Resourceful 
programmers copy the character generator into RAM and create their own 
characters. 


Remember to get out of BANK 15 when you are finished with the VIC 
register. 


SUMMARY OF THE OPERATION OF THE CHARACTER 
MODES 


Turn on the Extended Color Mode: 
POKE 53265,PEEK(53265) OR 64 


Turn off the Extended Color Mode: 
POKE 53265,PEEK(53265) AND 191 


Turn on the Multi-color mode: 
POKE 53270,PEEK (53270) OR 16 


Turn off the Multi-color mode: 
POKE 53270,PEEK (53270) AND 239 


In C-128 mode you have to turn off the interrupts: 
POKE 4864,120: POKE 4865,96: SYS 4864 


To turn the interrupts back on: 
BANK 15: SYS 27438 
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5.3 Character generator confusion 


In C-128 mode, RAM 1s repeatedly moved through interrupt calls so that the 
memory area in ROM that controls the VIC's character generator can be 
accessed. 


Bits 1 through 3 in memory location 53272 contain the address of the 
character generators. The contents are dependent upon other factors and are 
more difficult to change. Therefore, all of the following statements are for 
the normal configuration. 


The following table shows which bit configuration points to each memory 
region: 


COMBINATION REGION 


O00 0 

001 2048 
O10 Upper Case 
O11 Lower Case 
100 8192 
101 10240 
110 12288 
111 14336 


The combination of 010 and O11 are a special cases. They address the 
character ROM (53248 through 55296). 


The best way to access the three bits in location 53272 is to use the AND and 
OR functions. AND the byte with the binary number 1111 0001 (=241) to 
change the 3 bits in the byte. This will cancel all the bits which were set to 1 
back to a Q. Then POKE the actual bit combination that you want into the 
byte using the OR function. 


To have the character generator use the region at 2048, the bit combination 
O01 must be placed into address 53272. However, we can't change bit O of 
this byte--it is always set to 1. We instead create the decimal equivalent of 
the bit combination, in this case a 1. We have to shift the bit combination 
one bit to the left. To do this multiply the number by 2. The entire command 
looks like this: 
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POKE 53272, (PEEK (53272) AND 241) OR 2 


You can place the character page in the graphics region, but you cannot use 
graphics at any time. You can protect this region by using: 


GRAPHIC 1: GRAPHIC 0 


One of the advantages of this is the fact that you can turn on the entire 
character page just by turning on the graphics. 


To automatically load the character generator you have to use a loading 
program (See Section 3.3). 


You can use the following code: 

5 REM Copying the Character page for the C-128 
10 BANK 14 
20 FOR I=0 TO 4095:POKE 8192+1, PEEK (53248+1):NEXT I 
30 BANK 15 
When you have copied the character ROM to RAM and have changed the 
pointer, the characters retain their old form only because they are generated 
from the patterns in RAM rather than ROM. They are now easy to change 
the matrix is different (8x8 instead of 21x24) in memory. 


To examine the pattern you can use the program listed in Section 5.2. You 
will have to change the base address in line 20 from 53248 to 8192. 


The new characters are now easy to POKE. There is no limit to their creative 
applications, especially in the multicolor mode. 


You can turn off the normal generator and get at the new character page by 
using: 


For upper case. 
POKE 53272, (PEEK (53272)AND 241) OR 4 
For lower case. 


POKE 53272, (PEEK (53272) AND 241) OR 6 
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When we turn off the interrupts in the C-128 mode, we have to take care of 
some other chores that the interrupt normally does itself. After every 
interrupt, the memory location 2604 is copied into register 53272 where the 
operating system retrieves its information. We have to do this ourselves 
when we disable the interrupts. This is why it is best to turn off the 
interrupts only when we have to. 


The C-128 mode offers yet another way to define characters. Memory 
location 217 determines if the VIC uses the character generator in ROM or 
from the RAM in BANK 0. Normally this location is set to 0. This indicates 
that the character generator is located in ROM. We can change this location 
using POKE 217,4. This would allow the VIC to get its characters from 
the region between 4096 through 8191 (without the need for interrupts). 
Normally, this would cause a lot of interrupts from the BASIC interpreter. 
There are only 256 bytes, from 4096 through 4351, that we are allowed to 
use. The function key assignments are normally saved in this region. If we 
ignore these definitions, we can define 256/8 = 32 different keys. 
Unfortunately, the first 10 bytes (4096-4105) of this memory area must be 
set to 0. This means we will only have room for thirty characters. The first 
will be composed entirely of zeros, and the second will have zeros for its 
first two bytes. You can change the remaining 30 bit patterns as you please, 
though, and POKE them into memory. Remember that you can PEEK the 
locations following 4351 but you cannot change them. 


Of course, 32 characters are not very many but they are enough for most 
purposes. 


This 1s the same for the region of 6144 to 8191. This 1s the color matrix for 


the high-resolution graphics. If you want to use this region you have to be 
in the graphics mode. 
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SUMMARY OF THE CHARACTER 
GENERATORS 
Bits 1-3 of the memory location give the location of the generator. 
You have to be aware that the BASIC memory region 1s protected 
(See section 3.3) 
To turn a page on: 
POKE 53272, (PEEK (53272)AND 241) OR X 
To turn off a page: 
POKE 53272, (PEEK (53272)AND241) OR 4 (6) 


In the C-128 mode change the location from 53272 to 2604. 


The second possibility for the C-128: VIC gets its information from 
RAM 


ROM: Off? .POKE Z17,4 
ROM on : POKE 217,0 
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5.4 Video RAM confusion 


Similar to the character generator, video RAM is located in the memory 
from 53272 (2604: C-128). | 


The location of video RAM is set by register 24. The controller bits for 
register 24 are 4 through 7. 


With these four bits you can alter the location of video RAM in one kilobyte 
increments. Normally only bit 4 is set. This selects the memory range from 
1024 through 2023. Once again here is another table of bit combinations: 


The Value of Bits 4-7 Location of Video RAM 
in Register 24 

OO00 0) 
0001 1024 
0010 2048 
0011 3072 
0100 ROM 
0101 ROM 
0110 ROM 
O111 ROM 
1000 8192 
1001 9216 
1010 10240 
1011 11264 
1100 12288 
1101 13312 
1110 14336 
1111 15360 


As you can see from the bit combination, the ROM is an exception. You 
must note that the VIC uses the character generator in ROM. These regions 
are in memory from 4096 through 8191, instead of at 53248 for the VIC. 
These can be changed and used with AND, OR, PEEK, and POKE. The high 
four bits are set to zero. This is most easily done using AND 15. The 
binary combination is set from decimal. If we wanted to use the video 
RAM from 15360 we should use 15. This number must be multiplied by 
16 to move the bits to the proper location. It is then OR’ed with the number: 


POKE (53272, (PEEK (53272). AND -L5) “OR X 
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Is there a connection between the number X and the binary combination 
above? Yes, there is! This determines how much memory in kilobytes the 
video RAM will take up. In the future you will not have to do the 
wearisome calculations to determine how many K this should take up by 
using this command: 


POKE::532727 (PEEK (932/72) AND 15) 0OR K*16 


This command can be a bit of a disappointment. You may see an awful 
mess of characters on the screen. We have forgotten the operating system 
region where the video RAM is located. The VIC is getting all of its 
information about what to display from a place where the operating system 
is non-existent. If you are in this situation you can press the <CLR> key 
and the operating system will clear video RAM and color RAM. 


The computer uses the high-bits of memory location 2619 (C-128) or 648 
(C-64) to store the video RAM starting address. This number multiplied by 
60 is the actual address. For example, if we want to start at 15360: 
15360/256 yields 60. If we use POKE 2619, 60 the C-64 is back in order. 
Luckily, there is a method that makes things easier. If we multiply the 
kilobyte number by 4 we get the high-byte. Unfortunately, the C-128 is 
somewhat stubborn, the INPUT command only works on the normal video 
page, unlike the C-64. 


There are also a few things that you must pay attention to if you are also 
going to use sprites. The sprite pointers are located between 16376 through 
16383. Once again you have to remember to protect the BASIC program 
storage when you change the video RAM. 


It is possibile to define two different screen pages and then switch between 
them. The PRINT command can only access one of the pages, and the 
other has to be accessed using PEEK's and POKE’s. Another problem is 
that the color RAM has to use the same color for both pages. 
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SUMMARY OF THE VIDEO RAM 
The video RAM is controlled by bits 4-7 in location 53272. The 


number of kilobytes that the monitor screen memory is to take up 1s 
set by K: 


POKE. 532/727 (PEEK(532/2) ANDIS)OR: K*16 
POKE 648,K*4 


The C-128 uses location 2604 of the VIC switch and 2619 for the 
address high byte. 
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5.5 Different tricks for the 40-column screen 


As with the normal character mode there are certain tricks for programming 
of normal text. 


Let's begin with colors. The color register for the VIC 1s in a specific 
location. You can only change bits 4 through 7. The color codes vary from 
O to 15 and so only bits 0 through 3 are used. 


Once in a while, you might have to access a byte at a specific memory 
location in the video RAM. There is a pointer to the beginning of each 
screen line at locations 224 and 225 (C-64: 209/210). If you add the 
contents of location 236 (C-64: 211) to this value, you have the address at 
which the cursor is located in video RAM. 


There is also a pointer for the color RAM: 
PRINT PEEK (226) +256*PEEK (227) 


This points to the address of the beginning of the line for the color RAM. 
The C-64 mode is somewhat different, the pointer in bytes 243/244 directly 
gives the location of the cursor. 


You can position the cursor to a specific screen location before a PRINT 
command. In BASIC 7.0 it is very easy—yjust use the CHAR command. 
The same ROM routine can be called for the C-64 mode using the following 
command: 


POKE 214,line:POKE 211,column:SYS 58732 


Have you ever wanted to turn the cursor on during input with the GET 
command? This really isn't very hard. Location 2599 (C-64: 204) informs 
the the interrupt routine if the cursor should be displayed or not (in this case 
a PEEK (2599) produces a zero). When we start a program the location 
2599 is set to 1 by the interpreter and the cursor begins to blink. 
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We will look at what the operating system does in a short while. By using 
POKE 2599, 0 the cursor is displayed. The interrupt routine doesn't think 
about it again. If we turn off the cursor with a POKE 2599,1 we have to 
make sure that the cursor is not in the middle of a blink, therefore leaving a 
reverse video character on the screen. This 1s very easy to do 1n the C-64 
mode. All we do is wait using an IF statement until PEEK (207) becomes 
zero, then we can turn off the cursor. 


Unfortunately, all we can do in the C-128 mode 1s print a blank character at 


the same location the blinking cursor was at to take the cursor off the 
screen. 


To keep the input here is a tip for the next INPUT command: 


INPUT "text(eCrsr 2i0ont)(Crsr raghne) 2. (ersr AdAegic) 
(COrsr Jefe) (crsr. Jere). AS 


The Z is used as a cursor character upon issuing the INPUT command. As 
soon as a key is pressed the character disappears. 


The next commands use the reverse video mode. Independent of whether 
or not the input string has a special control character in it you can use: 


POKE 243,1 (C-64: POKE 199,1) 

to print the string in reverse video. You can return to normal mode using: 
POKE 243, 0. 

Do you want to print the control character of a string on the screen? 
Location 247 (C-64: 216) has the command. This contains the quantity of 
inserts. As we know, control characters are not printed in the insert mode, 
rather they are printed in reverse video. This mode can be turned on using 
POKE 247, X where X is the number of characters to be output. 
Once more we are going to play around with the operating system. If you 
have used the Datasette then you know that during a cassette operation the 
monitor screen goes blank. Once again the VIC is responsible. Bit 4 of 
location 53265 decides if the screen should be displayed. 
To turn the screen off use: 


POKE 532657 PEEK(9S32650). AND’ 239 
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To turn the screen back on again use: 
POKE 53265, PEEK (53265) OR 16 


This should be used only for static (no movement) pictures since the VIC 
only periodically operates on the screen. 


Perhaps you were working with the text window but somehow the screen 
was lost. Luckily, there is the WINDOW command. The command uses 
either 2 or 4 coordinates. If the window size does not change, you can get 
these coordinates using a PEEK. The location 228 gives the height and 
location 229 the bottom edge. The borders are found in bytes 230 and 231. 


SUMMARY OF 40-COLUMN SCREEN TRICKS 


Actual position in the COLOR-RAM: 
for the C-64: 
PRINT PEEK (243) +256*PEEK (244) 


for the C-128: 
PRINT PEEK (226) +256*PEEK (227) +PEEK (236) 


Actual position in video-ram: 
of the C-64: 
PRINT PEEK (209) +256*PEEK (210) +PEEK (211) 


for the C-128: 
PRINT PEEK (224) +256*PEEK (225) +PEEK (236) 


Cursor column: 
PRINT PEEK (236) C-64: 211 


Cursor line: 
PRINT PEEK(235) C-64: 214 


Moving the cursor: 
POKE 211,column:POKE 214, line:SYS 58732 


Turning on the cursor: 


for the C-64: 
POKE 204,0 
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for the C-128: 
POKE 2599,0 


Turning off the cursor: 


for the C-64: 
POKE 204,1 (PEEK(207) blinking phase) 


for the C-128: 
POKE 2599,1 


INPUT with a special cursor: 
INPUT"text (2*crsr-right) Z2(3*crsr-left)";AS$ 


Turning on reverse video: 
POKE 243,1 (C-64: 199) 


Turning off the reverse video: 
POKE 243,0 (C-64: 199) 


Alternative character mode: 
POKE 245, X (C-64: 216) 


Turning off the screen: 
POKE 53265,PEEK(53265) AND 239 


Turning on the screen: 
POKE 53265, PEEK (53265) OR 16 
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High resolution graphics 


The C-128 mode makes graphics very easy—yjust turn on graphics, then set 
or clear the pixels. Although the graphic commands are flawless, there is 
still a little more that you might want from your graphics. 


6.1 The graphics modes 


The section below is similar to one in the Commodore 128 System Guide, 
but for the extra features we want, it helps to understand the hardware. 


As with the normal character display, there are also different modes for high 
resolution graphics. There is no extended-color mode in high resolution 
graphics. In the normal mode we can access 320x200 pixels. These 64,000 
pixels can be accessed with 8000 bytes (much like the character generator). 
This region of memory is called the bit-map. The bit-map is similar to a 
elevation map, but in place of hills and valleys we have bits that are set to 1 
and/or 0. These bits are represented on the screen by pixels. The color of 
the pixel is determined by the video RAM (not by the color RAM). Every 
byte in the previous screen memory represents a specific region, which in 
the normal mode represents a character. The four high bits, which have 
been set to 1, determine the color (0-15) of the pixel. The low four bits, 
which are set to O, are for the background color. 


When the GRAPHIC command 1s given, the computer automatically saves 
the video RAM in another location so that the old, screen text is not 
destroyed. 


In the multicolor mode the pixel matrix is made smaller. Instead of 320x200 
pixels we now have only 160x200 pixels to use. Every pixel now requires 2 
bits to be displayed, which means we still need 8000 bytes for the bit map, 
but each cell can be any of 4 colors. The colors no longer come from the old 
video RAM, but from both the background color register 0 and the color 
RAM. The two bit pixel combination derives the colors as follows: 


OO from register 53281 (background) 

Q1 from the upper four bits of video RAM 
10 = from the lower four bits of video RAM 
11 from color RAM 
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6.2 The bit map 


Now something about the location of the bit map in memory. Once again 
location 53272 has the information we are looking for. The state of bit 3 
determines where the bit map 1s located. If bit 3 1s 1, the bit map starts at 
location 8192, otherwise the bit map starts at location 0. We will usually 
avoid the zero page, for we could overwrite part of the operating system if 
we are not careful . 


The set up of the bit map is similar to that of the character generator. The 
first 8 bytes give the 8 pixel lines for the first quadrant. This means when 
you turn on the graphics you can still display normal characters on the 
screen. All you have to do 1s copy the character generator into the bit map 
and change the bytes. 


The multicolor mode is also quite similar. The only difference is that each 
pixel is twice as wide and requires two bits (as we stated in chapter 5). 


The location of the bit map makes it necessary for us to protect the program 


Storage area. In the C-128 mode, the computer takes care of this for us, 
however in the C-64 mode we have to do this ourselves. 
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6.3 Turning on graphics in the C-64 mode 


To turn on the graphics we have to follow three steps. Then we must protect 
the bit map area in memory. We can do this with a loaded program (when it 
is finished loading) with the following commands: 


POKE 43,65:POKE 44,63:POKE 16192,0: NEW 


This should be done in direct mode. Now the graphics can be turned on by 
the program. In order to do this bit 5 in location 53265 must be set to 1. 
This tells the VIC not to display characters but to display high resolution 
graphics. If you want more colors, you have to set the multicolor bit in 
location 53272 to a 1 (just like in the character mode). Then we set the 
location of the bit map by setting bit 3 of location 53272 to one. Finally we 
have to save the video RAM so that we don't destroy the screen when the 
graphics mode is activated. 


When you finish this you will probably see a somewhat chaotic screen 
display. We still have to perform one last step. Using a FOR-NEXT loop we 
have to clear every byte of the bit map, because the video RAM information 
is still there. Here are the complete set of commands to do this: 


POKE 43,65:POKE 44,63:POKE 16192,0:CLR: 
REM MEMORY PROTECTION 
POKE 53265,59: REM TURN ON GRAPHIC MODE 
(POKE 53270,216:REM MULTICOLOR MODE) 
POKE 53272,40: REM BITMAP+VIDEO RAM 
FOR 1=8192 TO. 161912 .POKE 1,02NEXT: 
REM CLEAR MEMORY FOR BIT MAP 
FORT=2048 TO 3047: POKE I, pixel-color * 16 
+background color: NEXT : REM SET COLOR 


After these POKE's video RAM occupies the area of memory from 2048 to 
3047. Starting in location 3072 we find another 5K for such things as 
sprites and machine language routines. 


All graphics must come to an end, so to return everything back to normal 
use the following commands: 


POKE 53265,155: REM TURN OFF GRAPHICS 


(POKE 53270,8: REM TURN OFF MULTICOLOR) 
POKE 53272,21: REM TURN ON CHARACTERS 
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If you have been trying these graphics tricks, you have probably struggled 
with the slow process of clearing the bit map. To speed things up a bit we 
have written this machine language routine listed below. 


O FOR I=3600 TO 3659:READ A:POKE I,A: NEXT 

1 DATA 169,32,133,252,169,0,133,251, 
162,31,160,0,145,251,136, 
208, 251,230,252 

2 DATA 202,208,246,160, 64,145, 251,136, 
16,251,169,8,133,252,165, 
2,162,3,160 

3 DATA 0,145,251,136, 208,251, 230,252, 
202,2088,246,160,232,145, 
251,136,208,251 

4 DATA 141,0,11, 96 


You can start this program by entering SyS 3600. It will clear the bit map 
and then load the video RAM (2048-3047) with the foreground and 
background colors. Which color is loaded depends on location 2. 


To set the colors you want use this statement: 
POKE 2,color *16 + background color 


This machine routine can be relocated to any area of memory. The 
beginning address is always the byte where the FOR-NEXT loop in line O 
will start. This will take only a fraction of the time than using BASIC. 


Finally, a small tip if you want to use sprite graphics, colors and the 
clearing routine all in the main program on a diskette or cassette. This is 
actually quite easy. After loading the sprites, machine routines and so forth 
in a protected region of memory, the pointer in locations 43/44 is pointing to 
the normal beginning spot for BASIC. Naturally, you can save memory by 
changing the pointer to a higher address. For example, if the color RAM 
does not have to be saved. This program can (using only loading routines, 
with the pointer set) be loaded using LOAD "name",8,1. Now the 
graphics, sprites, etc. are all in memory. This 1s very helpful when 
programming games. 
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SUMMARY OF GRAPHICS IN THE C-64 MODE 


With the following POKE's you can turn on high-resolution 
graphics and multicolor graphics. The video RAM hes between 
2048 and 3047, and the BASIC start must be moved to 16192. 


POKE 53265,59: REM HIGH RESOLUTION ON 
(POKE 53270,216: REM MULTICOLOR ON) 
POKE 53272,40: REM VIDEO RAM SAVED 


Now to return the video RAM from its saved location and remove 
the bit map. 


POKE. 93265; 155: REM TURN OFF ‘GRAPHICS 


(POKE 53270,8: REM TURN OFF MULTICOLOR) 
POKE 53272,21: REM TURN ON TEXT+ 
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6.4 Setting pixels in C-64 mode 


When you want to set a specific point on the graphics page, you can first of 
all draw your picture on graph paper and calculate the appropriate RAM 
location. You may correctly surmise that this method would take several 
days and nights of calculation and plotting (not to mention a few hundred 
tablets of aspirin). To preserve your sanity we have included here two 
routines that make the process faster and easier. 


6.4.1 Setting pixels in the high resolution mode 


The program listed below works on the same principle as the block graphic 
routine in section 5.1. This time we don't have to POKE special graphic 
characters so we don't need a table to determine where we are going to put 
the character. 


61000 REM SET AND CLEAR PIXELS HIGH-RES 

61010 Y=199-Y: IF Y<0O OR Y>199 RETURN 

61020 IF X<0O OR X>319 THEN RETURN 

61030 X1=INT(X/8): X2=INT(X/8): 
AD=8192+8*X1+320*X2+(Y AND 7) 

61040 X3=2%(7-(X AND 7)): 
CA=20484+X1+40*X2 

61050 POKE CA, (PEEK(CA) AND 15)OR 16*CO 

61060 IF L=1 THEN POKE AD,PEEK(AD) AND 
(255 - X3) : RETURN 

61070 POKE AD,PEEK(AD) OR X3: RETURN 


The routine is invoked using GOSUB 61000. The coordinates x(0-319) 
and Y(0-199) give the point where the pixel should be set. The coordinate 
system's origin is in the lower left corner. The coordinates for X and Y 
cannot be set outside of their limits so lines 61010 and 61020 will ignore the 
command if either value is outside of its proper range. 


Line 61030 calculates the address of the byte within the bit map that should 
be changed. The part INT (X/8) calculates the column in the color RAM. 
This word is multiplied by 8, so each cell in the color RAM 1s 8 bytes long 
and represents a location in the bit map. INT (Y/8) calculates the line in the 
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color RAM. In order to get to the actual address in the bit map, this word is 
multiplied by the value of the pixel in line 320. Y AND 7 automatically 
calculate the color quadrant. 


The variable X3 tells the word which bits should be set. AD has the address 
of the pixel to be POKE'd, CA has the color. Line 61050 POKE's the color 
CO(Q-15) in the high 4 bits of the color cell. Don't forget that changing the 
color of a pixel will change the color of the entire quadrant. 


If L=1, then the routine clears the given pixel. In this case line 61060 1s 
executed, otherwise the line sets the pixel to 1. A typical call for this routine 
iS: 


5 POKE 53265,59: POKE 53272,40 

10 X=100: Y=25: REM SET THE COORDINATES 
LS CO=2: L=0: REM color=red, mode=set 
20 GOSUB 61000: REM CALL ROUTINE 


6.4.2 Pixels in the multicolor mode 


In the multicolor mode you have to set 2 bits for each pixel, for every color 
combination. You can use the earlier method, but you will have to call the 
setting routine twice. For the first bit, simply double the X-coordinate. For 
the second bit, just add one to the doubled X-coordinate value. Each of the 
two bits are in the same byte. With a few simple changes you can do this 
and avoid calling the routine twice: 


61000 REM MULTICOLOR PIXELS 

61010 Y=199-y:IF Y<0O or Y>199 THEN RETURN 61020 
XX=2*X:IF X<O OR X>318 THEN RETURN 

61030 X1=INT(XX/8): X2=INT(Y/8) : 
AD=8192+8%*X1+320*X2+(Y AND 7) 

61040 X3=2%(7-(XX AND 7)): 
X4=2% (7-((XX+1) AND 7) ) 

61050 POKE AD,PEEK(AD) AND (255-(X3+X4) ) 

61060 POKE AD,PEEK(AD) OR ((CO AND 2)/2*X4): RETURN 


Once again this is called with GOSUB 61000, and the coordinates are the 
same as before [X (0-159), y (O-199)]. The color and set/clear modes are no 
longer needed. The number for the color (Q-3) 1s in CO. To clear a pixel 
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simply set CO to O. The color from the bit combination is set using POKE to 
the needed register (the video RAM takes care of the clear routine). With 
just a little change the lines 61010 through 61030 are still pretty much the 
same as with the high-resolution mode. 


Line 61040 combines the bit combination in variables X3 and X4. Then the 
two bits are cleared (line 61050). Finally, the bit combination of the effected 
pixel is set in line 61060. The CO AND 1 puts the combination in the lower 
byte, and (CO AND 2) /2 puts it in the high half. If a bit is zero the entire 
product is zero. The reason: the affected bit from memory OR’d with zero 
always produces zero. If the bit is a one and the bits are OR'd, the result is 
always a one. 


Here is an example of a typical call to the subroutine: 


5 POKE 53265,59: POKE 53272,40 

10 xX=100: Y=50: REM coordinates 

15 CO=2: REM ‘color: “for the high bats ain the 
video RAM 

20 GOSUB 61000: REM Call to the routine 
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6.5 Spirals 


After this indepth explanation of the C-64 mode graphics manipulations, 
we'll return to the graphics commands of BASIC 7.0. 


Very few figures have as many variations as the spiral. There 1s really no 
simple program for such a figure, although the principle is always the same. 
In order to understand the spiral we have to take a small step backwards and 
draw a circle "by hand." That is what the following program does: 


5 PIl=7 
6 GRAPHIC 1,1 
10 FOR I=0 to 359 
20 DRAW 1,160+SIN(I/180*PI) *100,100 + COS(1I/180*PTI) 
* 100 
30 NEXT 


Look how easy it was to set 360 points. The coordinates are the SIN and 
COS multiplied by the radius 100. Experiment with different numbers. A 
spiral is basically a circle with a constantly growing radius (mathematically 
we have to apologize for this imprecise explanation). The following 
program does this for us: 


6 GRAPHIC 1,1 
10 LOCATE 160,100 
20 FOR I=0 TO 8000 STEP 10 
30) X=COs(I7 Le04P 1) 41/7 e0+Le0: 
Y=SIN (1/180*PI) *I1/80+100 
40 DRAW TO X,Y: NEXT 


You can produce an inifinite variety of spirals by changing the parameters of 
the above program. For example, the number of windings 1s controlled by 
the program loop length; the smoothness of the spiral is controlled by the 
loop's step width; the distance between the spiral windings is controlled by 
the radius, etc. 
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6.6 Pie charts 


Piechart graphics can be displayed with the BASIC 7.0 quite easily. Below 
we have listed a small subroutine which you can tie into one of your 
programs: 


Ss) REM PIECHART 6.6 
6 GRAPHIC 1.4 
10 F=1: X=150: Y=100 
20 XR=75: YR=50 
30 AZ=10 
35  GOSUB 61000:END 
61000 REM PIE CHARTS 
61010 WB=0O: FOR II=0 TO AZ-1 
61020 WA=WB:WB=WB+W (II) *3.6 
61030 CIRCLE F,X,Y,XR, YR, WA, WB 
61040 DRAW TO X,Y: NEXT 
61050 IF XRSYR. THEN: CIRCLE -1,X%, V3 ;,XR;7 YR; 65472759: 
PAINT 1,X,Y+YR+5 
61060 RETURN 


Before you call this routine with aGOSUB 61000, you have to set certain 
variables. The value in F is the color, X and Y have the coordinate of the 
center of the circle. XR and YR are both radu. If XR 1s greater than YR we 
get a 3D effect. This 1s accomplished in line 61050. 


This program has values which describe how the diagram looks. AZ 
contains the number of points which are going to be in the circle. Notice 
that all elements must add up to 100. 


To realize how the graph is made you have to understand how the 
parameters to the CIRCLE command work. The DRAW command draws a 
line from the middle of the circle to the border. Line 61050 determines if the 
circle will have a 3D look to it. In this case we DRAW an ellipse under the 
circle, and fill in the area. 
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6.7 Painting program 


You've probably heard of computer-aided design programs, like 
Cadpakfrom Abacus, that let you easily create sophisticated graphic 
designs on the screen. These CAD packages offer you many design 
possibilities. For example, you can create your own greeting cards with a 
specialized motif, and then print them out. Here is a simplified version of 


such a CAD program: 
10 fori=1to067:reada:a$S=a$+chr$ (a) :next 
20 graphicl,1:locatel60,100:x=160: y=100:f=1: 
30° sprsav as;lisprite 1,1,270;,0;70;0 
40 movspr 1,173,140 
50 asS="";getkey a$ 
60 ifaS="(crsr down)" then if y>0O then 
mOovVsprl,+0;)—15 YVH=vaLe -qotoo0 
70 aif aS="(crsr up)" then if y<199 then 
movspril,+0;+1sy=yrlL2 gotos0 
80 if aS="(crsr left)" then if x>0O then 
MOVspr lL, = lL, 70s x=x=1% gers) 
90 if aS="(crsr right)" then if x<319 then 
moveprl,+l,+02x=xt1% Goto50 
100 ifaS=" "then drawf,x,y: xa=x: ya=y: goto50 
110 if aS=chr$(13) then drawf,xa,yatox,y: xKa=xX: 
ya=y: goto50 
120 ifaS="p"then paintf,x,y: goto50 
130 afaS="f£"then f=1-f£: goto50 
140 ifaS="sS"then 1000 
150 ifaS="1"then 1100 
160 ifasS="t"then 1200 
L170: Goto: 30 
1000 graphicO: print"save bit map" 
1010 input"Qfilename";fS:bsave (£$),d0,u8,onb0,p8192 
1020 graphicl:goto50 
LOO GraphicOsprint load bit. map” 
LiilO anput" filename"? fS*bload(£5)i>. ad0;18,;0nb0;p8192 
1120 graphicl:goto50 
1200 getkeya$:ifa$S=chr$ (13)then50 
i210 Chart ,;x/78;y/87chrs (14) +as% Lt x<3k then. e=xt5: 
movsprl,+8,+0O:gotol200:else50 
9000: dataly-16, 0705-16, 07.05 1.65.0 7.0, 160 
S001. -dataly 16,07.0716; 0,071 6707-07 16,0 
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9002 ‘data 7 Oy: 070407072057 131720470; 07 07 0 707-0 7510704 
O,16,0 

9003 ‘data 0, 16,;0;,0,16;,0,0716;0;)0, 16,0, 0; 1; 6; 07 0,16, 
0,23,0,20,0 


A sprite can be used as the graphic cursor. It is always located over a pixel. 
The cursor is moved using the cursor keys. The space bar sets an individual 
pixel. Pressing the <RETURN> key draws a line from the last pixel that 
was set to the pixel at the current cursor location. You change the color of a 
pixel (0 or 1) just by pressing the F-key. P starts a PAINT command at the 
actual cursor coordinates. 


If you want to save your painting at some point, S will start the SAVE 
routine. You are prompted for a filename. The bit map will be saved to 
diskette. The LOAD command is started with the L key and operates in a 
manner similar to the SAVE routine. 


There is a small treat with the T key. This key will put us in the text 
mode—every key stroke is displayed on the screen in the approximate 
position of the current pixel with the help of the CHAR command. You stay 
in this mode until you press <RETURN>. 
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6.8 Hardcopy 


If you want to see your results from the painting program in black and white 
you need a hardcopy routine. Actually, this 1s best handled by a machine 
language program. Printing a picture requires that the entire graphic page 
(64000 pixels) be loaded, coded, and sent to the printer. This takes quite a 
while. We have two hardcopy programs in memory because the codes that 
must be sent to specific printers are quite different. 


The first program is for the MPS-801 or compatible printer. The MPS-801 
can print 7 vertical pixels at a time. Therefore, the bit map must be accessed 
with 28 lines of 7 pixels and another line with 4 pixels in the high bytes. In 
all, this gives 320 columns. The inner FOR~NEXT LOOP gets the 7 pixels 
and builds a variable BY. When this byte is finished it 1s sent to the printer 
(Line 60). After 320 columns, the printer head has to return to the leftmost 
position and the paper is fed one line. Then PRINT#1 prints the control 
characters (Line 70). 


The second program is for the EPSON or compatible printer. It 1s almost the 
same as the first program. The MPS-801 automatically sets its graphic 
mode. The Epson does not do this, so we have to send a special control 
character to do this before sending the rest of the data. The graphic mode is 
activated for only a single line, so this mode must be set before each new 
line 1s printed. Other than this, the only remaining difference with the 
previous routine is that the Epson can print 8 pixels at a time. Therefore, the 
inner FOR-NEXT loop 1s a little different. 


With both programs you'll notice just how slow the BASIC interpreter 
really is. To reduce these effects we can set the FAST mode.You can also 
get rid of all the REM lines to save some execution time. Don't worry if 
nothing happens for a few seconds after you start the program. 
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1 REM +4+4+4+4+4+4444+4+4+4+4+4+4+4+4+4+4+4+4+4+4+4+4+4++4+ 

2 REM MPS-801-GRAPHIC HARDCOPY 2.0 

3 REM Raa E see ee ee oe ee 

5 GRAPHIC1,1:FORI=100TO220STEP10: 
CIRCUE: dy Ly LOO, LOOs NEXT GEEREY AS 

10 FAST:OPEN1,4,7:PRINT#1,CHRS (8) ; 

20 FORZ=0TO27 

30 FORX=OTO 319:BY=128 

40 FORY=0TO6 

50 LOCATE X,Y¥+2*7:BY=BY+RDOT# (2) *2°*Y 

60 NEXTY:PRINT#1, CHRS (BY) ; 

70 NEXTX:PRINT#1 

80 NEXTZ 

90 FORX=0T0319:BY=128 

100 FORY=0TO3 

110 CONTX, Y+196:BY=BY+RDOT# (2) *2*Y 

120 NEXTY:PRINT#1,CHRS (BY) ; 

130 NEXTX:PRINT#1 

140 PRINT#1,CHRS$(15);:CLOSE1 

150 SLOW 

160 GRAPHICO 


1 REM +Htt+etetettetttettttttttttttettetetett 
2 REM EPSON-GRAPHICS-HARDCOPY 2.0 
3 REM +4+4+44+444+44444444+44+4+444+4+4+44+4+4+4+44+4+ 
5 GRAPHIC1,1:FORI=100TO220STEP10 
CIRCEB LE, 1,100, LOO: NEXT ?GETKEY: AS 
10 FAST:OPEN1,4,1:PRINT#1,CHRS$ (27); 
CHRS (51) ; CHR$ (23) ; 
20 FORZ=0TO24:PRINT#1,CHRS$ (27) ; 
CHRS (75) ;CHRS (64) ;CHRS (1) ; 
30 FORX=0T0319:BY=0 


40 FORY=OTO7 


om Sa VJ SAN ob OTO9 

50 LOCATEX, Y+Z2*8:BY=BY+RDOT# (2) *2%(7-Y) 
60 NEXTY:PRINT#1,CHRS (BY); 

70 NEXTX:PRINT#1,CHRS$ (13) ;CHRS (10); 


80 NEXTZ 
oC sCGOSEL 
100° SLOW 


110 GRAPHICO 
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6.9 3-D graphics 


Three-dimensional displays are undoubtedly the most interesting type of 
graphics. However, they also take the most time to produce. We have listed 
a small program to make things a little easier. 


We have to change the coordinate system. In contrast to the normal two 
axes, we now have three axes: x, y, and z. 


The z-axis is "slanted" to provide the needed perspective (see Diagram 
6.9.1). 


Since the DRAW command doesn't have parameters for three dimensions, 
we have to transform the three dimensions to two dimensions. This 1s called 
a projection. We will just work with simple parallel projection. In reality, 
parallel lines run into the distance without ever converging. 


As you can see in the picture, the z-coordinate has to be moved either more 
or less to the right . There are two points on the z-axis with the coordinates 
(0,0, za) and (0,0, zb). As you see, the projection coordinates are 
determined through the addition of the factors za*cos(a) and 
zb*sin(a). The projection formula 1s: 


x=Otzaxcos(a) y=0t+za*sin(a) 


or in the more general form: 
xX=xa+za*cos(a) y=yatza*sin (a) 


Because this 2D coordinate system is not always the same as the screen 
coordinate system, we have to have a dimensioning factor (sx,sy)—(See 
program listing, line 100). The coordinate origin 1s determined by adding 
the needed factor to position the picture in the middle of the screen. 


From the three orginal coordinates only one needs to be computed, so we 
can use two nested FOR-NEXT loops. 


In the program below, all the values that must be altered often (for 


experimentation) are entered with INPUT commands. The program runs in 
graphic mode 1. 
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Type in the following program and run it using the following values: 


w=45, sx=0.5, sy=0.5, xS=2, zS=20 


1 REM +++++++44+4+4+++4+++4++4+4+ 
2 REM 3D GRAPHICS PLOTTER 
3 REM +4+++++4++4+++++4+++++++4++ 
10 INPUT "Angle";w: 
Z1=cos (w/180*PI) :z2=sin(w/180*PI) 
ZO INPUT "X~-dimension";sx 
30 INPUT "Y-dimension";sy 
AQ INPUT "Step length X";xs 
a0 INPUT "Step length z";zs 
60 GRAPHIC 1,1 
70 FOR z=180 TO -180 STEP -zs 
80 FOR x=-180 TO 180 STEP xs 
90 y= Sin(x/180*PI) *cos(z/180*PI) *50 


£00 bx=1600+Sx* (x+z*z1): 
by=100-sy* (y+z*z2) 

110 DRAW 1,bx,by 

20 NEXD 2yzZ 


Perhaps you noticed a problem with the program. A point that should 
normaliy be hidden by another shows through. To solve this problem, we 
must use what is called hidden point removal. Change line 110 to: 


110 DRAW 1,bx,by: DRAW 1,bx,byt+l TO bx, 200 


We'll explain this with an example. We will draw a single surface. The 
surface is plotted obliquely from the bottom to the top in the space. The first 
point plotted is the one that 1s closest to the bottom—therefore no points can 
be below it. We then take the y-coordinate plus one and cover all points 
below. All points below this given point are not set. This method even 
works for the lines which contain curves. You will understand better if you 
run the program and see for yourself. 


You might want to make a few changes to the program. Line 10 calculates 
the cosine and sine of the coordinates. Since these values are constants, they 
can be calculated once and saved in variables. This will save a lot of 
calculation time later on. The numbers in the FOR-NEXT loop (lines 70 and 
80) can be changed to allow for smaller or larger steps. 
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In line 90 you may change the value of the multiplier (50 in our program). 
This equation always produces values that are less than 1. The values only 
need to be set once. However, this value can be changed from function to 
function. 


Experiment with different values to see what each value does to change the 
functions. 





yY = Sin(x/180*PI) * (sin(z/180*PI) * 70 
Diagram 6.9.1 





y = sin(x/180*PI) * 2 / (z/8+.5) * 40 
Diagram 6.9.2 
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a = x/180*PI b = z2/180*PI 
vy = exp (=(a*atb*b)/2)/7. saqr(Z*P1)*300 
Diagram 6.9.3 





y = sin(x/30) * (exp(z/90) - 1 / exp(z/90)) * 10 
Diagram 6.9.4 
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6.10 Raster line interrupts 


Even though you may not have known what it was, you have undoubtedly 
used a raster line interrupt before. These are used primarily in graphic 
modes 2 and 4. 


As you probably know, a TV or monitor screen 1s projected line by line. 
These lines are also called rasters. Using the VIC chips you can determine 
where in the raster a picture is to be placed. The operating system calculates 
at which raster line the division between graphics and text will take place. 
The VIC is programmed so that an interrupt is given at the nght time. At the 
correct moment, the processor switches the program through the VIC from 
graphic mode to text mode. At the bottom border of the screen this little 
routine is repeated, except it is switched from text back to graphics. 


You can thank the programmers at Commodore for this aggravation. In 
BASIC, the interrupt occurs after only 8 lines in the text mode, although the 
VIC issues more lines. Using this method, the highest pixels of a text line 
are mixed with the graphics. To change this you only have to alter location 
2612. Here you can POKE the desired raster line into memory. This is 
explained in the following example: 


10 GRAPHIC 2,1 

20 FOR I=0 TO 100 STEP 10 

30 CIRCLE dy160,200;,2 

40 NEXT 

50 PRINT" (CLR) (3xCRSR DOWN) GRAPHIC" 

60 PRINT" (3xCRSR DOWN) and text" 

70 PRINT" (3xCRSR DOWN) are mixed" 

100 FOR I=48 TO 248: POKE 2612,1:NEXT 

110 FOR I=248 to 48 STEP -1:POKE 2612,I1 
>NEXT 

120 GOTO 100 


SUMMARY OF RASTER INTERRUPTS 


Memory location 2612 gives the current raster line. These bytes can 
be manipulated with POKE. 
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Sprites 


In this chapter we are going to assume that you have already read both 
chapters on sprites in the Commodore 128 System Guide, and that you 
understand how they operate. The following text has techniques for the 
C-64 mode sprites only, but these same techniques are made extremely easy 
with the sprite commands in BASIC 7.0. 


7.1 Multi-color-sprites on the C-64 


To turn on the multi-color mode, put the sprite number in the correct bits in 
VIC register 28 (53276). For example, to define sprite 6 in the multi-color 
mode use the following commands: 


POKE 53276,PEEK(53276) OR (2%6) 
use these commands to set the byte back to zero: 
POKE 53276, PEEK (53276) AND (255-2%6) 


Remember, in the multi-color mode 2 bits are needed to set a pixel. This 
leaves us with a 12x21 matrix. You already know how this mode operates. 
All you need to learn are the bit combinations needed to get certain colors. 


If both bits are set to O the pixel is the same color as the background color. 
If both bits are set to 1, the VIC gets the color from the multi-color register 
in locations 37 and 38 (53285 and 53286). Which color is used is 
determined by bit 2. If this bit is set to QO then register 37 1s used, otherwise 
the VIC uses register 38. If the combination 1 QO is used the color comes 
from the normal sprite color register. In multi-color mode each sprite cannot 
be a different color as they can in other modes. In multi-color mode the 
Same registers are used for all sprites and these range from O to 7. 
Multi-color sprites are just like normal sprites, only the conversion from bits 
to pixels is different. 


Warning: Turn the sprites off when accessing the floppy drive (POKE 
53269, 0). 
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SUMMARY OF MULTI-COLOR SPRITES 
To turn the mode on: turn the correct bits on in register 28 (53276). 


The colors come from register 37 for bits 01 or from register 38 for 


11, the normal color register for sprites 1s used 1f the combination 1s 
10. 
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7.2 Sprite Collisions 


The VIC checks its registers every time a sprite comes "in contact" with 
another sprite or non-background color pixel. A collision of two or more 
sprites sets register 30 (53278). The numbers of the affected sprites are 
found through this register using: 


PRINT PEEK (93272) AND: 2°n 


If sprite n was involved in the collision the result of this command will be 
zero. In BASIC 7.0 there is a command for this, BUMP. A collision is 
indicated if two pixels actually touch. The bits remain set and you can see 
them using the PEEK command. It may happen that a collision is announced 
even if the sprites are not actually touching. We recommend that after each 
look at the register, you set the bits back to O, since the register does not 
reset itself. 


The control of the background spmnite collision follows in the same manner. 
The bit of the corresponding sprite in the register is set to one if the bit map 
or the character generator places a sprite over a pixel. In other words, every 
collision of a sprite with another character 1s registered. This is recorded in 
register 31 (53279). This register must also be reset to zero after a collision 
as it does not reset itself. Fortunately, in C-128 mode you can use the 
COLLISION command to check this register for you. To illustrate the 
programming of sprite collision control, a small game program 1s listed. It 
demonstrates a very simple auto race. To aim the car use the key Z (=left) 
and / (=right). If the car touches the borders or another car, a sprite 
collision 1s caught in either register 30 or 31, and the car crashes. You can 
omit the REM statements to make the program run a little faster. These are 
only for easy referral. 


SUMMARY OF COLLISIONS 
Collisions of sprites with other sprites or background characters are 
indicated by setting the specific bits in one of two registers. These 


are registers 30 (53278) and 31 (53271) of the VIC. The bits 
remain Set until the user accesses either register. 
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| ak 01 Pe ee Gee ee ee ee oe oS 

2 rem @129 car race 7.2 

CEPT bette be be ee be tbe eee eee eee tbe ei hee the fr fe ore slr mfr af mfr safe fr fir fr en 

1@ senele@scolorag, lacolor 4,lrrem sereen init 
Lalization 

e@ for 23584 to 2646:re@ad arpoke l,ainextire 
Mm auto Soria ANput 

a8 for 225648 to 271 G@sread arpoke L,arnextire 
mcrash sprite input 

40 poke 2440, 56:poke 2@41,56:rem sprite point 
er & counter 

Wy seperate 1,1,2,80,1,1,@a:gprite 2,1,3,0,1,1,0: 
rem activate sprites 

mM for ae to S4rpoke 103441440, 160: poke S530 
oti ¥40, 1 

6Q poke LASS+1*#40, 160: poke SSSR 7+, #40, lamext 
ierem road output 

7Q™@ moavepr L,1l6oe,l7aex=166irem put car at star 
t 

SM mavepr 2,168,a0shx=L68shy=Adiream obstacle st 
ay t 

2M collision T,20@:collision 2, 20@:rem collis 
tan cantral turned an 

120 a= peek (2aledaream pall keyboard 

1iQM@ af aie then ee 2 key 

L2Q@oaf aBSS then x=xtlsarem / key 

128 moavepr a eae mave the car 

LS@ hyehytes af byee4a then hy=28srem mave fro 
m battoam 

160 heehee antcrnd (tid eS) asa Ff Aes led then hx 
mis Msrem raad turns lett 

L7O@ af he tele then Axe lésrem raght turn 

184 movepr @yhx,hysqatoal@@:rem obstacle move 
YQ poke 2040, 57: sleep earunercem crash 

L@OW rem auto sprite data 

L106 data @,@,@ 

Li@i data @,126,0 

JIE data YW, 126, @ 

L1i@s data 2D, 255. 

1144 data 12, 255,48 

LIQ data 135,255, 240 


an 
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HALE 


cat aa 
data 
data 
data 
data 
data 
data 


data 3, 


data 
data 
Chat a 
data 
data 
data 
data 


rN) Stas 


data 
data 
data 
data 
data 
data 
data 
data 
data 
data 
data 
data 
Gata 
data 


data 22 


data 
data 
data 
data 
data 
chat ae 


ie eo, 48 
OW, 255. 

0.255, 

OC Be at cn 
1,195,128 
1,195,128 
Lg Pas oe 
Ly og Fe 
agok Pas poked a 


115,255, me & 
PS oe 
Le7, 255, 254 
115,255, 206 
Ls 2s OG 


2,,2 


125,20,@ 
a, 24, @ 
30,44, 77 
21,126,% 
240,125,48 
15, 205,240 


1 205,156 


1,201,108 
hein 
oe 


,115,192 


ar ee Log 
“eee! flee Gti ae ves 


oe wld 
,O9S One 


OE , Bene 
wey le, 48 
Z , 2, M 


sprite 


data 
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7.3 Priorities and movement regions 


Sprites are usually superimposed over an existing screen picture. However, 
you can also place a character in front of a sprite on the screen. For 
example, you can have a sprite which represents an airplane pass behind a 
house. The VIC has a register to control the sprite "transparency". 


Register 27 has the address 53275 (V+27). The bits in this register 
determine the priority of the sprite being drawn. Each sprite has a 
corresponding bit in the register. The sprite corresponding to the lowest bit 
will have the topmost priority. If you want to change the priority of a sprite 
use this command: 


POKE 53275, priority number 


Remember, any new sprite that you draw will automatically have a priority 
above the others on your screen. 


The coordinates of sprites and graphics don't correspond directly. The 
movement region of the sprites is better defined as the output of the sprites 
to the monitor. You can put a sprite in the upper-left corner of the screen 
with the coordinates 24 and 50. These coordinates are the correction factor 
that you have to add to the graphic coordinates in order to correctly position 
a sprite. The middle of the screen is calculated with the values 160+24 and 
100+50. 


SUMMARY OF PRIORITIES 
AND MOVEMENT REGIONS 


Sprite priorities (before / behind) are controlled by the appropriate 
bit in the VIC register 27 (53275). By setting the bits the sprite then 
being printed 1s placed behind the current character. 


The correction factor for sprites to graphics coordinates: 


24 (X coordinate) and 50 (Y-coordinate) 


94 


Abacus Software Commodore-128 Peeks & Pokes 


7.4 Programming with sprites 


Many game programs use animation to create movement on the screen. For 
example, a small sprite man has to run through a maze to get to (or get away 
from...) his sprite wife. With a second look you can see that there are only 
two or three positions for the arms and legs. The principle of animation is 
easy to understand. You have two blocks of sprites which are switched 
back and forth and moved along, giving the appearance of movement. In 
one block the man has his legs and arms in a somewhat closed position, and 
another with the legs and arms in a stretched out position, as if striding. If 
these two pictures are switched the figure appears to be running. You can 
see this for yourself with the SPRITE command. Unfortunately, the 
disadvantage to this method is that you can only have 8 different pictures. It 
is better to change the sprite pointer directly (2040-2047), then the VIC will 
be able to switch to another memory region easily to get a new picture. 
These pictures can be put into different section of the first 16K of the BANK 
O, or else in the user region 1300-17FF. All you have to do is divide the 
region into blocks of 64 and put the value in the sprite pointer by the POKE 
command. 


Notice that the sprite pointer for the graphic region is in addresses 8184 
through 8191. 


The natural assumption of all this is that there is enough room for the 
different pictures. To make sure there's room, move the BASIC start 
address to a higher address in memory. 


The following program rolls a ball across the screen. It uses four different 
sprites. 
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ball 7.4 
coh ck C1 4b?) 


tec oe a 


lL orem 
a Se Bc a 
LQ fer 
rest 


e ac 


2e@ for ae#@ to 62eread arpoke deca ("Meda") +1 ,as 
mex t 
28 for i= to 62aread aspake dec ("Wedd d+i ,as 


t 
$ coy" 
t 
Sori. te 
pakke 2 
pak e 


Men 
4.) 
rey 
a) 
old 
7@ 


read aggoke dee C'Oec@ ki, aa 


1, PO i 
1=9 ta 
1=4 to 


QQ: maven r 5 OP GES 


S5inext 


erat 


»laemovepr 
eT ote ok 
a A 


SW poke 2O449,582 for 1=8 toa 35: next 


Oo BOefor peM to BSsanext 


1a@ 
ea falla) 
eo 4. 


poke 
gata 
data 
data 


= 
bby 240 


O,120,8,3, 
192,164,731 


1359 O12, 


q AL 


on, ome eng 


gee 


oor” wlaoe 


"Oe data 51, 240,64, 31,248, 64,2 1,246 


oy sony 
Hes teal 


we Qh 4 


ieee On aae 
4 abies Seed fee 


af 


ene fae ey ba i 
Bee ne Bod y Hee Nad Sood 
“ety 


(224,868,127 


a ae Ff 


a 
(2 


dat 
date 


64, 51,248,128, 


ey es or4 ey Ee be ca 
aes gee 555 24, 4, 
oye 


HGS data 224,8,127,224,98,65, 224,16 
or PN “wy mr fh ee | gin 


CNA ZL. 
ete KS CD 


oa? 
eal el? 
oe ae 


oot Mee he Need 


dake 
date 
date 


£7 Wire 4 2. 
Hed Mseel ee bal a Le, MC H's 4 
" 


,3,251,0,8,128,2 
O,12@, O,3,125,0, iZ,@ 
192,14, 2 S4.O,112, 


weeny 


eee, 


& (21 


"1? data O,240,196,1,248,127,5,248 
215 data 127,135,248, 255,207,252, 255, 255 
S14 data 252,255, 207,252,127,1355, 248,127 


as Ee 
mh 
oie 
pies 


ery ey ony 
wey dl 


my a 
Bien obeee 


chat 
ee 


lat se 


fee 
data 
cleat aa 
Chat é 
cheat a 
cheat at 
clata 
data 


, 124 
112516,8, 37 


14 
a 


meg Ah mA 
Edy g dhs 
192, 
@, 12 Q jig. 
192, ae | 
mety le, 
baa 234, 8 
eetegee 
fy Ob, 
cA’ , 
oe 4 39 4 Bas 


J 1, 248,468,@, 
4 soe o 4 0 
a, WV) 

12 915 ae 


ae 


_ res 
a ny he tus aed v] (A 4 , y 
v a as 
ae We “sae? vi 
my ey ao 
Toy ot 


i Li 7 4 eae : 


“4 
16,63 
ODA, 3 


ge 9 oer a Bo os 
9 lad wd ahr Aad sod 


4 AE, Gd 
)32,31,248 
12,31 


¢ Sate 


: voyage 9 fh 4 


125264, 
a ii y o 2 (4 
Loy Bd OO 


120,08 


a 
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sod Gate Ug les Oy ace o. Uy Loyaoe 

eel data 1 92 4 gba gana hs 47 :- 256 ,2S 39 
eee Gata 255,144,67,255,8,65, 254,68 
coe Gata 64, 252 ai L2B,128,4,128, 4g 
cot Gata 4, 1 °t3 . , 4, 44, 2859 ee 45 

ow data 254, S407 6 28598 SO yg sded g L444 

2G Clata 47, 255 : 208 , Si eet fe tye hye 
eof data 192,3,255, a, W,120,0 


It is often useful to save sprite blocks on diskette or cassette. A program for 
saving them was given in section 4.1 for the C-128 mode for the BSAVE 
command. 


One interesting misuse of high resolution sprites is to use them as small 
screen graphics inside of the character mode of the C-64. Let's say you 
want to display your favorite graph. However, you also want to add some 
comments on the graph. In the C-128 mode there is the graphic mode 2. 
One possibile way is to save the pixel matrices for the letters in a region of 
memory. This method, however, is very time-consuming. The other 
method uses sprites. We will need four, arranged in a square about the 
needed position on the screen. We must calculate for every pixel which bits 
to set inside of the sprite matrix. This is what the routine listed below will 
do. 


lL rem c64 plotter 7.4 
1Q@ for 1704 to eae lag yg @snearxt 
“QO for vege to (Mehr poke 1,@4:nex%t 
~aQ@ poke 2040, 11spokezaat, barpoke 24042, 14: poke 
asi ae 
40 ve ae4B8rpokev,lOdspoke vel, TOO: poke vere, 14 
a ito Vt, 1GQ 
“8 poke oan. IOs poke vtS, 142: poke vte, 148s pok 
@ v+7,142 
&%) dor A= IYO to 42:poke vti,linmext is:poke vt 
Lricspoke vtea,lSspoke v+e29,15 
90 print che# (147) 
1G anput "xecoord "axerinput "y-coord "ry 
11@ gosub 62008: gotola@ 
O&2000 yeti-yrif yi@ or yr4i then return 
6GeOlG@ if «e@ or “i447 then ratucn 
620209 bxeeqqnt  ¢« /i24) s bys a af bx ane 
by=@ then ba=7/@4:qoto 62 A«4G} 
ed ABA) s ueeaechaitani ok 


bere 


a} 
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62048 been Sato pbysy2 dl eb y 

ae MSM xdieimk Cox 7/8) axes Coe and 7) ax Seby es 
6240680 ad=batx 3+x | 

Ge2@72 af Jel then poke ad,pe@ek (ad) and (RES-2 

“ye Sore thurn 

62080 poke ad,pee@ek Cad? or C2aex BR) rreturn 


This routine is called with GOSUB 62000. With high resolution graphics 
the coordinates are in X and Y, and the mode (set or clear) is in L. This 
routine uses the sprites 0- 3 and the blocks 11 513,14,15. In the 
aforementioned version the sprites are enlarged in both directions. If you 
want the normal size to be displayed you have to correct the position (see 
lines 30 and 40). 


Inside of the 4 sprites you can set 48x42 pixels. This routine will not handle 
multi-colored sprites—all ihe pixels must have the same color. The color 1s 
set in line 50. 


We are now finished with this section on sprites. We hope that you will 


continue to experiment with sprites. There are many different possibilities 
for sprites in all sorts of applications. 
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The 80 column screen 


One special feature of the C-128 allows you to display more than a single 
screen of text, graphics or data all at the same time. 


This is possible since the computer has two different video chips installed: 
1. The VIC, which is identical to the one in the C-64. 


2. The VDC, or the Video Device Controller, a new part of the 
computer, whose purpose in the C-128 is to relay the RGB output. 


We will be discussing the VDC in this section. 


The purpose of the VDC is to take care of the RGB output. RGB stands for 
Red, Green, and Blue. These are the three colors that a normal color 
monitor is composed of. The colors are not composed from a single signal, 
as they are in a TV transmitter. There is a separate signal for each of the 
three colors. 


At first glance, this may look quite complicated. The big advantage to RGB, 
though, is that you get the color you ask for. This is rather difficult to do 
with only one signal. What makes the VDC so likeable is not only the fact 
that it produces an RGB signal, but also that it uses its own 16K portion of 
RAM, not main memory. The information about the screen and character 
portion is located in this area. 


It is possible to save the contents of the screen in the main memory. It 1s 
therefore possible to write a routine that uses the same information for 
different types of monitor screens. 


The VDC, as with the VIC, controls register 37. This register is important 


throughout the rest of this chapter. A complete memory map 1s available for 
the C-128 in Appendix E. 
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8.1 The RAM region of the VDC 


The RAM region of the VDC is divided into the three following areas: 


l. 


Z. 


Video RAM 


This is where the characters that appear on the monitor screen are 
saved. The addresses that encompass the VDC region are from 
$0000 through $3FFF. The region for the characters goes from $0000 
through $07CF (We will see why this is important in a little bit). 


Attribute RAM 

This is the region from address $0800 through $OFCF. This region 
directs the monitor. These are the 2000 bytes that are used to direct 
the output to the video RAM of the specified character. In order to 
accomplish this every byte in the video RAM has a corresponding byte 
in the attribute RAM. The output of the character depends on the bits set 
in the corresponding attribute byte. 


BitQ: Lightness. If this bit 1s set the character is displayed in a color 
of aslightly lighter shade. 


Bit i: Biue. The specified character is partly blue. 
Bit 2: Green. The specified character is partly green. 
Bit 3: Red. The specified character is partly red. 


Bit4: Blinking. The specified character will be blinking when 
displayed. 


Bit5: Underlined. A character of the video RAM will appear 
underlined on the screen. 


Bit 6: Reverse. This bit allows two possibilities; reverse, where the 
character appears reversed on the monitor. The second 
possibility is that the reverse character that also exists in the 
character ROM 1s displayed. 
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Bit 7: Alternative Character Set. This is different than the C-64 mode 
since the 80 character screen 1s different. You can change the 
character set with the <SHIFT> and the <COMMODORE> 
keys. The reason for this is that both character sets are present in 
the VDC and they can be switched simply by setting the 7 bit. 


3. Character Generator 
The character generator can be found in memory locations $2000 
through $3FFF. This region takes up a full 8K. The reason it takes up 
So much space is: 





a) The character generator contains both character sets. 


b) The definition of each character requires 16 bytes. One word has 
the form described, the other is a null word. 


The rest of the RAM region for the VDC 1s reserved for high-resolution 80 
column graphics. You are probably asking yourself why you haven't come 
across this in any other C-128 references. We'll satisfy your curiosity in the 
next section. This section painted a rather crude picture of the VDC—we'll 
take care of the details later. 
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8.2 The VDC's registers 


Now that we have praised the VDC, we have to look at the other side of the 
coin. The VDC's registers are quite complicated. This is because the VDC 
only has two registers that you can directly manipulate. These two registers 
are enough to cover the RAM region. 

The two VDC registers have the addresses $D600 and $D601. 

The only way to use the registers is as follows: 


1. The number of the working register is in location $D600. 


2. The value in the register mentioned in location $D600 is in location 
$D601. 


For example: 
POKE. DECC’ D600" ))30)POKE. DECC’ DOOD") 4-20 


Register 30 contains the value 10. If you want to see the value in a given 
register, use PEEK (DEC"D601"). 


It is somewhat more complicated to manipulate the bytes in the VDC RAM. 


The first step 1s to specify the address that is to be changed. This happens 
with the help of registers 18 and 19. 


Now the value in register 31 must be written. To complete the procedure we 
have to POKE register 30. This is to determine how often the character in 
registers 18 and 19 are to be written. 

Here 1s an example: 


1. POKEing the address 


POKE DEC ("D600") ,18:POKE DEC("D601") ,12 
POKE DEC("D600"),19:POKE DEC("D601") ,4F 
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2. The value is written: 

POKE. DEC ("DOO0")-7. 31S POKe..DEC tC" DOUL" ) gilz 7 
3. Finally: 

POKE DEC ("D600") ,30:POKE DEC("D601"),1 


As you can see this 1s quite complicated, but what's worse, it doesn't 
always work. The precise alteration of the contents of memory can only be 
accomplished with machine language. 


The program listed below makes it easy to change every byte of the VDC: 


10 fori=4864t04864+33 

20 readx:pokeli,x:next 

£0: Caetal62, 155-169 70,32922j7 197 2327 L690, 
Of SE CELL (sop LOZ pop OO Oy S2s 2c} 
9,262, 1.85 142,07; 214744;.0, 2147.5; 
2g age 2 Ae OO 

D0. “ho=dec ("1309") -ni=dec(" 1303"): 

we=dec ("1310") 

60 fori=0t01l999:rem Address 

70 pokelo,1i and 255 

80 poke hi, 1/256 

90 poke we,127: rem character 

LOO sys dec ("1300") 

110 next 

120 getkey aS 


With the help of this program you can influence the contents of the VDC 
RAM. This makes it easy to POKE into the screen, the attribute, or into the 
character generator. For example: if you want to change the character 
definition in the character generator, you get the address of the character 
with the simple expression: 

Address = 8192 + 16* (character code) 


This address and the following seven locations contain the character. 
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High resolution graphics with the 80 column screen 


As we mentioned in the previous chapter, the VDC can also be used for 
high resolution graphics. The graphics for the VDC are twice as sharp as 
those for the VIC, there are 640*200 pixels that are all monochrome. 
Unfortunately, these graphics are not supported by the new BASIC 7.0 


1 rem pixel set 9.1 

~ goasub Baa 

1@ a=dec ("déd@")ad=atlerem starting address 
“@ poke a,c@Srpoked,128:rem turn an graphics 
-<@ print chr# C147) s 

40 for i1=@ toa 3a 

WO print "GEEEeeeeGECEEGEERGGEGEEGGEEeGEGaaaa 
G@@aa" s 

6@ mext 4 

7@ poke a,24: c=peek (d) 

SQ poke a,24: poke d,corl?2s 

[8 poke a,22: poke d,@ 

1@@ poke a,J3S:irpoke d,@ 

110 for a 1 to 63 

1240 adr=1e*256:hiFadr/256:loszadr and 2355 

120 poke a,1lSB:poke d,hi 

14Q@ poke a,19spoke d,la 

130 poke a, 320spoke d,@ 

164 mext i 


al@ : 

22g ram coordinates are calculated (gosub 148 
Q) 

2aO : 

o4Q 


ev gaosub 108s and 
1Q@Q@QO lofedec ("L309") shisdedc ("LEME") sweden ("42 


1@1iQ@ ad=int («x /8) +y*8@ 
I@2@0 xiead/256 

I@20 x@ead and 255 

1940 poke a,18:poke d,xil 
1@30 poke a,l9srpoake d,x2 
1@6@ poke a,3i:c=peek (d) 
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1QO70 poke la,xe 

1@8@6 poke hi,xl 

1298 poke we,c aor BU C7—Cx and 7)) 

1100 sys dea ("1g") 

L11i@ return 

"M08 for a= 4864 to 4864+35 

eWl@ readxs poke Ll, xinext 

eOMng data Lon, 5G ce gt ene gar 4 Cr ale are ae a »,169,8,32, 
ne i aro eo ee a 149 0,32, 22 AT ws a Glee ig, oes 214, 
44,0,214, 16,251, 141, 1.214, 96 

2020 Lo=dec ("1309") thisdec ("1303") :we = dec ¢' 
LST") 

HOY for 1 O@ ta 1999:rem address 

eQsQ poke Llo,i and 235 

“O60 pakke hi ,i/e2So 

2470 poke po, l2e7irem character 

“U8 ays dee (1 agg") 

SOP next 

elie return 


mw rem black copy 9.1 

LQ a=dec ("de@@")sdeatiirem starting address 
oY poke a, zgcSspoked, 1 2gerem turn on graphics 
ag print cheé (147) 

40 for pe@ to @s 

a print "GEEeeeeEeGeaeeGeeGEECaeEeaGaGeeaeeeaeeaea 
GEeGEeGeeaGEGeeCGeEGEEGGEGEEEGGeGe"s 

60 mext 4 

7Q@ poke Ayes cos sneak Cc) 

SM poke a,aés ans Chi Or Lek 

YA poke a,- eee pake d,@ 

IW poke a,o3spoke d,@ 

LIQ for oe: L to 3 

129 adr=18#2Sorhieade/256: lomadr and 255 

L2Q@ poke a,lGsrpoke d,hi 

L4@4 poke Ay lit pake cd,zlo 

1SQ poke a,2@spoke d,@ 

160 mext 4 
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9.1 The bit map 


You have probably already figured out the location in memory for these 
graphics. It is in the 16K of RAM that is under the direction of the VDC. 
This means it 1s possible to put both graphics and normal text on to the same 
screen. 


The graphics regions of the video RAM, the attribute RAM, and the 
character generator all have access to the bit map. The bit map 1s responsible 


for the display on the monitor screen. Every bit that is set to 1 in this region 
turns on a pixel on the screen. 


9.1.1. The order of the bytes in the bit map 
The order of the bytes for these graphics is very user friendly. This makes 


the graphics very easy to use. 


Here's how the bytes are ordered. First we'll look at the upper left corner of 
the screen with a "magnifying glass": 


Addresses: 

Line 0: 0000 0001 0002 0003 0004 0005 0006 ... through 0079 
Line 1: 0080 0081 0082 0083 0084 0085 0086 ... through 0159 
Line 2: 0160 0161 0162 0163 ... etc. 


Here you can see that there is a byte-for-byte correspondence with the 
individual pixels until the line is full, and the next line begins. 


From this order you can calculate the address that has the pixel you want to 
change, as follows: 


Address = INT(X/8) + Y * 80 


The pixel (the bit) 1s just as easy to calculate: 


Value = 2%(7-(X AND 7)) 
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9.1.2 Setting pixels 


Before we start with the theory you will probably want to know how to 
enable graphics with the VDC. 


The main register is register 25 of the VDC. You can enable the graphics by 
setting bit 7. 


Use the following POKEs to enable the graphics: 


POKE DEC ("D600") ,25:A=PEEK ("D601") 


and 


POKE- ‘DEC (“D600O™") 529: 
POKE. DEC("D601™"),. 2 OR. 128 


To set the text mode again POKE the original value of D601 back into D601. 


When you first perform this operation there is a total mess on the screen. 
The pixel mix-up on the screen is simply the contents of the screen region of 
memory, for example, the attribute or character generator. 

We have listed a program on page 109 that should help you make clear up 
this video mess. Here is a short explanation of the program. 

First of all, we print "@'"s all over the screen. This 1s done with the help of 
a block copy routine. This fills the entire graphic region of the VDC and 
initializes the region. We could also do this with the 80-column POKE 
routine poking the "@" sign location by location, but the block copy 1s 
much quicker. 


On page 110 we listed a program that allows you to set pixels so that you 
can use the graphics. This program uses the 80 character POKE routine from 
the last chapter. This routine must be installed at the start of the program. 


When you want to finish your graphics, you have to reset bit 7 of the 


register back to a zero. This will return control back to the ASCII mode that 
you turned off earlier. 
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You have to protect the character generator region of memory before using 
graphics, or else you could destroy the characters in the RAM region of the 
VDC with your graphics. 
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Sound generation 


What the VIC 1s to video display, the SID (Sound Interface Device) is to 
sound generation. There is a register for every possible parameter. 
Unfortunately, these are not described in the Commodore 128 System 
Guide. Since discussing every facet of the SID is beyond the scope of this 
book, we only cover at the basics of programming sound effects. 


10.1. The operation of the SID 


In this section we briefly explain what happens in the computer when we 
want to generate a sound. 


If a specific start bit is set to 1, the SID produces a sound of a specific 
frequency or oscillation. This happens with a sort of "electronic potter's 
wheel", the Wave Form Generator. Through this, the sound is programmed 
with a specific wave form (triangular, square, sawtooth, round) and its 
characteristic sound patterns. 


The SID forms what 1s called the envelope curve. This determines what 
volume the sound will have in the different phases. The envelope curve 1s 
composed of four different parameters. Attack means how fast the register 
reaches the highest volume of the envelope. After the maximum volume, the 
sound will stay at this level for a certain length of time. This is the Decay 

parameter. Then sound then will reduce to the value in the Sustain 

parameter. The volume remains at this level until the startbit 1s returned to a 
zero. The Release parameter describes how fast the tone should diminish. 
This parameter allows you to produce reverberations or echoes. 


Other possibilities (that we won't discuss here) include: ring modulation, 


where the sound of each of two tones 1s dependent on the other; and filters, 
where you can filter out certain frequency ranges. 
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10.2 Programming sound in the C-64 mode 


In this section we will discuss programming sounds and sound generation 
in the C-64 mode. 


We know you want to see what a sound program looks like, but there are 
some things we have to take care of. 


The first is volume. This is located in the low 4 bits of register 24 (54296). 
If you want to see the contents of this register or the others (0-24) using the 
PEEK command, you will be disappointed. These registers are made so that 
they can be written to but not viewed. A PEEK to these registers yields 
garbage. 


The reverse situation exists in registers 25-28. They can only be read, not 
written to. Using a POKE will have no effect. 


The 4 high bits in the volume register are normally set to 0, but we can 
change these values witha POKE command. Using POKE 54296, 0 the 
volume 1s reset back to its normal value, with POKE 54296, 15 sets the 
maximum volume. The volume can only be set to multiples of 3. 


AT + tha f. ‘ 
a annrm a tranianry This determ 


in€Xct COMES rie rrequency. igh Or low the tone of the 
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sound gets. You can choose from 65536 different frequencies. For 
programming melodies, the appendix of notes in the System Guide is 
helpful. How you put the value of the frequency into the high and low 
bytes was discussed earlier, in the chapter about pointers. These numbers 
are in registers O and 1 (for voice 1), 7 and 8 (for voice 2), and 14 and 15 


(for voice 3). 


wtiws mines LOW 


Now we will discuss the envelope curve. The attack, sustain, and decay of 
a tone 1s determined in register 5 (12 or 19 for the other voices). The attack 
is in the high bits, the decay 1n the lower bits. The values for the sustain and 
reverberation are in registers 6, 13, or 20; the sustain 1s in the upper bits. If 
this value is set to zero the voice 1s silent. The volume of the tone 1s 1n ratio 
with the maximum In register 24. 


If you want to use square waves, the SID 1s equipped to play them. It can 
hold values between O and 4095 and store these values in the register pairs 
2/3, 9/10 or 16/17. Only the low bits of the high byte are used. Any 
numbers higher than 15 in these registers don't make any difference. 


118 


Abacus Software Commodore-128 Peeks & Pokes 


So far so good. Now we are going to deviate from the Commodore 128 
System Guide. The waveforms are set in register 4 (11 or 18, depending on 
the voice). Similar to the VIC memory locations, each bit has its own 
meaning. Bit O is the start-stop bit for the sound generator. When this bit 1s 
set to one, the sound with the correct voice and envelope wave is Started. 
When it returns to zero, the envelope curve and sound will die out in a 
specified amount of time. Notice, that the SID cannot produce another tone 
until the first has completely died out. Therefore, when programming 
melodies, you have to use a very short decay value, so that you can produce 
tones in rapid succession. 


Bits 1 and 2 in register 4 are for internal control. Bit 3 turns out to be quite 
useful to us. If two or more waveforms are present at the same time the SID 
shuts off all sound, and becomes quite confused. You can return the SID to 
a working state by setting bit 3 back to a 1 and by zeroing out the 
waveforms. To do this use POKE 54276, 8 to reinitialize the SID. 


The waveform is determined by bits 4 through 7. To choose a waveform set 
the corresponding bit to 1. Bit 4 1s for tnangular, bit 5 for sawtooth, and bit 
6 is for a square-wave. Bit 7 is for rounded waveforms. These waveforms 
can also be intermixed. 


To start a sound, the waveform and the start bit must be set using a POKE. 
For that you will need the C-128 System Guide containing the codes for 
different sounds (17, 33, 65, 129). Turning the sound off is not as simple 
as setting register 4 (11 or 18 for the other voices) to zero. That would be 
equivalent to turning off your engine in the middle of the freeway. The SID 
cannot suddenly start a waveform, and so it cannot suddenly stop a 
waveform. This would result in snapping off the sound. If you just reset bit 
O the sound will die off nicely. 
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SUMMARY OF TONE GENERATION 
Volume is in register 24: Range 0-1 
Attack: highbits in the halfbyte in Registers 5/12/19. 
Decay: lowbits in the halfbyte in registers 5/12/19 
Sustain: highbits in the halfbyte in registers 6/13/20. 
Release: lowbits in the halfbyte in registers 6/13/20. 
Waveforms: Register 4/11/18 
Bit 4: Tnangular 
5: Sawtooth 
6: Square 
7: Rounded 


Other: Bit 3: Initialization 
1: Start-Stop-bit 


Frequency: Register pairs 0/1, 7/8, or 14/15 
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10.3 BASIC 7.0 Music commands 


10.3.1 PLAY and ENVELOPE 


The C-128's PLAY command defines and plays musical notes and elements. 
It lets you select voice, octave, envelope, volume and notes. The syntax for 
the PLAY command is PLAY "voice, octave, envelope, volume, 
notes". The PLAY command has 10 preset defaults for musical 
instruments to make it easy to use. Here is an example: 


PLAY V1O4TOUSXOCDEFGAB 


So far everything sounds simple. You give a string of notes from a melody 
with the PLAY commands, and the C-128 plays the melody out. 


However, there's a hitch. The accordian preset does not sound much like an 
accordian—and the drum preset sounds something like small waves at the 
seashore. We will give you a little help so you can alter the sounds so that 
they sound right (although this strictly from our personal taste). Luckily, the 
original waveforms detailed in the System Guide can be altered with the 
ENVELOPE command. 


The sound that string instruments make decays quickly. 


The original envelope curve for the piano 1s nearly perfect, but the sound 
can be made better. Just change the pulse width to 600 (ENVELOPE 
O07 prey 000). 


A cymbal can also be imitated by setting that same value to 400. But the 
cymbal can generate sound for quite a while, so you should set the release 


time to 9 (ENVELOPE 6,,,,9,,400). This sounds especially good in 
melodies. 


The guitar also requires corrections. The waveform for this instrument is 
best suited with the square wave. The length of the attack has to be 
changed, because there is no perfect fit. The best we can do is to use 3500. 
The release time also has to be changed (ENVELOPE 
573737273500). 
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The flute sounds good, but the tone should decay much more quickly, so 
shorten it to 7 (ENVELOPE 4,7). 


Changes have to be made for the accordian also. The sustain 1s too low, so 
the correction for this is ENVELOPE 1,,,12. 


Now we come back to the drum sounds. Striking a drum creates a sound as 
quickly as it is hit, therefore, change the envelope with ENVELOPE 
377070 


The last critical point is the trumpet envelope curve. For the C-128 to sound 
anything like a trumpet, we have to change its envelope, especially the 


attack and decay times. Use the following command: ENVELOPE 
Op pss 


The C-128 is not limited to only the orchestral instruments. You can 
program vitually any sound you can imagine. To make the sound of a bell: 


ENVELOPE: 150,10-1470;72,2048 


And to make the sound of waves at the beach: 


Or if we want to make a futuristic sound: 
ENVELOPE 1,0,7,0,0,2,1800 
Experiment and you will find that you can create any sound you desire. 


SUMMARY OF THE ENVELOPE CURVE 


PIANO: ENVELOPE: OO; e777 74 000 
CYMBAL: ENVELOPE 6,,,,9,,400 
GUITAR: ENVE DOPE: S579 373-2 ps000 
FLUTE: ENVELOPE 4,7 

ACCORDIAN: ENVELOPE 1,,,12 

DRUM: ENVELOPE 3,,8,0 

TRUMPET: ENVELOPE 8,3,13 

BELL: ENVELOPE 1,0,10,1,10,2,2048 
SEA WAVES: ENVELOPE 1,11,11,0,11,3 
FUTURE: ENVELOPE 1,0,7,0,0,2,1800 
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10.3.2. SOUND 


The SOUND command is closely related to PLAY, and allows different 
acoustical possibilities. The sound of a motor 1s quite easy to duplicate. Just 
use a Square wave with a very small frequency and an oscillating impulse. 
For example: 


SOUND 1,1000,100,0,,0,2,200 
SOUND 1,400,100,0,,0,2,3500 


Of course, you can change the frequency and the length of the sound to 
emulate anything from a Diesel engine to a moped. 


Footsteps are also no problem. The command: 
SOUND: 2, 10 000;-15 05.7: 0y3 
makes a very quick sound like that of footsteps. 
A police siren can be simulated with the following: 
SOUND 1,20000,1000,2,5000,1000,2,2048 
You can change the length of the attack and the decay times with the sixth 
parameter. Moreover, the falsely named "max frequency" is parameter 5. To 
get a variable tone this parameter must be less than the starting frequency. 
SUMMARY OF SOUND 
MOTOR: SOUND 1,1000,100,0,,0,2,200 
SOUND. 15°400,10070;-5:0 7-2; 3500 


STEP: SOUND: ,:7:00000;.10}:,0,-3 
SIREN : SOUND 1,20000,1000,2,5000,1000,2,2048 
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The keyboard 


The most noticeable feature of the C-128 is its new keyboard. It is probably 
the best keyboard for a computer in its price range. Not only does it provide 
comfort when typing, but it also has all kinds of features for programming 
tricks. 


11.1 Construction and operation of the keyboard 


Normally, the keyboard 1s accessed with INPUT and GET. A glance at the 
Commodore 128 System Guide will show that the keyboard is also device 
number O and can be accessed with the normal OPEN command. Now the 
keyboard can be used just like a floppy disk or cassette. Unlike the normal 
INPUT command this method will not yield a question mark. 


The interface to the keyboard is CIA 1. However, the VIC must also come 
in to play. The CIA 1 executes polling of the C-128 keyboard from the two 
parallel ports (closely related to the user-port). It reads 64 keys which are 
electrically divided up into 8 lines and 8 locations. The remaining 3 lines of 
the keyboard (the cursor keys and so forth) are connected to the VIC and are 
set in register 47. The two ports are programmed for output. This 1s where 
the output from the polling appears. When a key is pushed port B is 
switched to input. The interrupt routine gets the next key from the input 
buffer. This is then sent to the ASCII decoding table and this new value is 
replaced where the original value was. 


When the interpreter is running in the direct mode, it gets its information 
from the keyboard, converts it to ASCII, and then processes the ASCII to 
produce a BASIC code (for example RETURN = 13). When a program is 
running, the keyboard buffer is unaffected until a GET or INPUT 1s found. 
With a GET command the interpreter simply gets one character from the 
keyboard buffer and stores it in the command variable. An INPUT 
command functions similarly, except that the characters come from the 
keyboard and the interpreter doesn't continue until the <RETURN> key is 
pressed. 
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The keyboard matrix has its own peculiarities. The <RESTORE>, <CAPS 
LOCK> and <40/80 DISPLAY> keys have no entry in the matrix. The 
<RESTORE> key works directly with the processor (similar to the 
<RESET> key) and uses its own special interrupt. This routine checks to 
see if the <RUN/STOP> key has been pressed. If this is the case, a sort of 
mini-reset occurs, and everything runs as before. The two other keys work 
on the MMU and change the way the system works. 


Another peculiarity lies with the <SHIFT> keys. The computer can detect 
the difference between the left and right <SHIFT> keys, since both have 
their own locations in memory. The <SHIFT-LOCK> key, however, sends 
the same code as the left <SHIFT> key. 


128 


Abacus Software Commodore-128 Peeks & Pokes 
11.2 Pressing two keys at once 


We will now discuss what we said in the last chapter in practical terms. For 
many programs we want to be able to poll different keys at the same time. 
An example would be: two spaceships that can be controlled independently 
by different keys. To do this we are going to look at the keyboard matrix. 


The three memory locations the keyboard is tied to are 56320, 56321, and 
53295. Normally all the bits in these registers are set to one. If a specific 
column is to be set, the effected bits in 56320 through 53295 must be set to 
Q. Similarly, the message is returned from the keyboard. If a key is pressed 
the appropriate bit is set to zero in location 5621. 


We will finally learn what the interrupt routines do. With a POKE command 
we can look at a specific column and test the individual keys. 


We can manually accomplish what the interrupt routine does: 


POKE 4864,120: POKE 4865,96:SYS 4864 
PORE. 56320,;-cOlLumn: code: 
POKE- 53295,column code 
IF (PEEK (56321)AND(28*%bit#)=0) 
THEN PRINT “KEY PRESSED" 
POKE 4864,88: SYS 4864 


We can test a key with this program, If you want to observe more keys, all 
you need are more IF-THEN constructions and more POKE commands to 
check the appropriate columns. The column code can be determined with the 
formula: 


CODE = 255 - 2%column number 
The column number determines the position of the bit inside the memory 
locations 56320 through 53295 for the appropriate column. The IF-THEN 
construction in the above listing tests for a 0 in the appropriate location. 
The line and column number can be looked up in the table matrix. 
Another possibility for checking two keys is to use location 211. This is 
where the actual <SHIFT> pattern appears. The pattern in this register tells 


whether or not one of the five special keys have been pushed (<SHIFT>, 
<C=>, <CONTROL>, <ALT>, <CAPS LOCK>), If it 1s the <SHIFT> 
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Key, bit O is set to 1. For the <C=> key it 1s bit 2, for <CONTROL> bit 3, 
<ALT> bit 4, and finally <CAPS LOCK> bit 5. The setting of one bit 1s 
completely independent of the others. It 1s possible for all five keys to be 
set at the same time. If we use this register, however, we must turn off the 
interrupt routine. Use the following command: 


I 


ty] 


(PEEK (211) AND2*5i#7) THEN PRINT "KEY PRESSED" 


The computer can use BASIC to determine whether or not a key has been 
pressed using this routine. 


SUMMARY OF CHECKING FOR MORE 
THAN ONE KEY BEING PRESSED 


There are two possibilities: 


a.PEEK(211) _ gives the shift pattern.With this we can check 5 
different keys independently of each other. 


b. You can check different columns with POKE 56320,X1 and 
POKE 53295,X2. To determine what key in the column was 
pressed check location 56321. The table we have been talking about 1s 
listed on the following page. 
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The keyboard matrix: 
Line Column 


56320 53295 56321 
(x1) (x2) 254 «253 251 247° «2239 «9223:«191=—«127 


254 255 del cr ~ F7 Fl F3 F3 J 
253 255 3 Ww A 4 Z S B sh.-L 
251 255 5 R D 6 C F T 4 
247 255 7 Y G 8 B H U V 
239 255 9 I Jj 0 M K O N 
223 255 + PL - : @ , 

191 255 £ - & home sh-R = T / 

127 255 ] « ctrl 2 space C= Q stop 
Additional Keys: 

255 254 HELP 8 5 TAB 2 4 7 ] 

255 253 ESC + - LF enter 6 9 3 

255 251 ALT 0. aR iH —- > nose. 
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11.3. Disabling keys 


For many applications it is necessary to disable individual keys, or even the 
entire keyboard of the C-128. 


In order to disable the entire keyboard it is advisable to turn off the interrupt 
routine. This means the cursor will disappear and the computer will lock up. 
You can restore the computer with <RUN/STOP> <RESTORE>. 


The same goes for the POKE 2592, 0. The keyboard 1s turned off, yet the 
cursor remains intact. The <RUN/STOP> key also operates. It is interesting 
to see how this actually works. This memory location is the length of the 
keyboard buffer. What we are doing is setting it to O (it's normally set to 
10). The operating system seems to think that the keyboard buffer is full 
and forgets the last key pressed. If you do this when you are in BASIC, 
GET and INPUT will not work. 


If you only want to disable the <RUN/STOP> key, you can use the 
command POKE 808,112. Now the BASIC program will only stop if 
you press the combination of keys <RUN/STOP> <RESTORE>. The 
BREAK function is returned with POKE 808,110. 


You can inhibit the mini-reset (<RUN/STOP> <RESTORE>) with POKE 
792,98. The <RUN/STOP> key still works. If you combine the 
previous two POKE's there is no way to stop a BASIC program (outside of 
turning off the C-128). You can re-enable the <RUN/STOP> <RESTORE> 
combination with POKE 792, 64. 
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SUMMARY OF DISABLING THE KEYBOARD 
Turning off the entire keyboard: 


1. Turn off interrupts 
2. POKE 2592,0 (Buffer length 0) 


<RUN/STOP> off: POKE 808,112 
<RUN/STOP> on: POKE 808,110 
<RESTORE> off: POKE 792,98 


<RESTORE> on: POKE 792,64 
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11.4. The key-repeat function 


You use this repeat function whenever you want to move your cursor 
around the screen. However, the other keys are also tied into this function. 
When you press a key, after a short period of time the computer continues 
to print a key over and over again until the you let go of it. It is possible to 
repeat immediately after pressing the key, rather than having to wait for a 
moment. Conversely, you can turn off the repeat function completely (for 
individual keys or every single one). You use the POKE statement once 
again to accomplish this. For every key to repeat, location 2594 must have 
the value 128 stored in it. This points to an interrupt routine that repeats the 
key. If you change this value toO (POKE 2594, 0), each key will only be 
printed once for each time pressed. This works for all keys except for the 
following: 


e The cursor keys 
¢ The <Insert> and <Delete> keys 
¢ The space bar 


It is possible to take away the repeat function from all of the keys. This is 
done with POKE 2594, 64. After this no key will have the repeat function 
available to it. 


SUMMARY OF THE REPEAT FUNCTION 


POKE 2594,128: Repeatall keys 

POKE 2594,64: Tumoff repeat function 

POKE 2594,0: Repeat only for cursor,insert, and space 
keys 
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11.5 Polling the keyboard one more time 


AS we mentioned earlier the interrupt routine puts the keys into the keyboard 
buffer as ASCII codes. During this time, the value is kept in a way Station, 
memory location 212. This 1s where the keyboard code is stored, it is a 
pointer into the decoding table. The code 1s saved in this register. You can 
look at this register with a PEEK (212). 
A key viewed with a PEEK(212) will not be placed in the keyboard 
buffer. You can use GET or INPUT to bring the value into a variable. You 
can then test the value in any way you wish. Outside of this the keyboard 
codes can only be stopped by turning off the interrupt routines. 
You can clear the keyboard buffer with the simple command: 

POKE 208,0 


It is then possible to have the computer wait until a key 1s depressed. To do 
this: 


POKE 208,0: WAIT 208,1 


As you can see, there are many possibilities for polling the keyboard. Don't 
be afraid to try something new. 


SUMMARY OF POLLING THE KEYBOARD 
PEEK (212) gets the keycode directly from the pressed key . 
POKE 208,0 clears the keyboard buffer. 


POKE 208,0: WAIT 208, waits for a keypress. 
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Table of K 
A = 10 P= 41 A = i 3 AG 
B = 28 Q= 62 5 = 16 = 50 
C = 20 R= 17 6 = 19 S = 53 
D'S i S= 13 7 290 RETURN = 1 
E = 14 Ts 2 e 97 = 47 
PSO U= 30 9 = 32 = a 
G = 26 v= oi en: S57 J =, 4 
H = 29 W= 9 * 1240 = - 2 
I = 33 ams S 23:3 Fl =a 
J = 34 Y= 25 £ = 48 F3 = 5 
K = 37 Z= 12 CLR= 51 F5 6 
Lea 0 = 35 DEL = 0 F7 = 3 
M = 36 1 = 56 a = 46 STOP = 63 
N = 39 2 =. 50 * = 49 SPACE = 60 
O = 38 3= 8 - 23554 

Additional Codes 
ESC =72 J -84 3 =79 9 278 
TAB =67 «& -85 4 = 69 + - 73 
HELP =64 -—- =86 5 = 66 : -74 
LIF =75 0O =f 6 277 29 
NO SC.=87 1 29 7 .290 ENTER = 76 
t =93: 9 =68 8 = 65 
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The User port 


The User port turns the C-128 into a very versatile instrument. 
Unfortunately, the handbook doesn't say a single word about how to 
program it or use it. We are going to provide some groundwork so you can 
program this port. 


All information in this chapter is true for both C-64 and C-128 operating 


systems. In the C-128 mode all you have to do is make sure that BANK 15 
is turned on. 


12.1 All about the building blocks 


Just as the keyboard and joystick use the CIA, so does the User port. The 
CIA is the building block. This chip's job is to receive and send information 
to the peripherals, as well as keep in touch with the processor. 


This building block 1s actually made up of three parts. The first is the input 
for the parallel ports. There is also the timer (which you have already used 
and need to know nothing else about ), as well as a serial port. 


The following sections cover the operation of these three elements. 
12.1.1 The serial port 


We are going to Start with the most simple part of the User port. As you 
may already know, a computer works 1n parallel mode. This means it works 
with 8 bits at a time. 


A serial port works more slowly than a parallel port, since it must work 
with one bit at a time. The operation of the serial port is fairly simple. It 
receives groups of eight bits from the processor and sends them out one at a 
time. 
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On the other hand, when the serial port receives information, it assembles 
the bits like pearls on a string. The port receives each bit individually, forms 
them into a byte and passes the byte onto the processor. 


If the processor had to do all of this work data exchange over a serial port 
would be extremely slow, since every bit would be input one at a time. 


Since data exchange in a serial manner 1s really only effective with a 
machine language routine, we wont be going into that here. There are, 
however, a complete set of routines in the ROM of the C-128 that can 
handle the RS232 serial port. You can work with the port using OPEN 
pees 


12.1.2 The timer 


Whenever there 1s any internal function that requires timing, it is handled by 
the timer. You can load the timer's register with any value you wish. This 
value is then continuously decremented. When the register reaches zero the 
timer sends a signal to the processor. An example of this is the internal use 
of the interrupts. The timer is programmed so that the intervals are 1/60th of 
second apart. When the processor reacts to the alarm sent by the timer, the 
main program 1s stopped and the interrupt routine 1s started. 


In this case it is time to clear up what happens when an interrupt routine is 
started. The 0 bit of the memory location 56334 is set when the timer sends 
the processor a signal. If the bit is set to zero, the timer 1s still running and 
no interrupt will happen. 


In the C-128 mode interrupts are handled differently, POKE's do not work 
with bit 0. 


Outside of the above, you shouldn't goof around with the timer. In most 
cases the computer will crash up if the timer is changed. 
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12.1.3. The parallel port 


All of the interfaces for the 6502 and 8502 have at least one thing in 
common: you can program the parallel ports. Usually, the operator works 
with two such ports, much like the CIA's. 


Each of these ports has 8 data lines that you can program for input or 
output. The chip has two special registers for this purpose. The data control 
register determines what mode the individual lines are set to. A 1 means 
output, and a O is for input. 


You must be careful when you use this register. If there is a O for the output 
mode, as it is with the start up of the computer, then any erroneous impulse 
to the peripheral devices could cause unknown problems. For example, data 
on a diskette could be erased. 


The second register for the ports has different modes for different purposes. 


The first byte is for the input functions of the register, so the processor can 
use the input data from the port. 
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12.2. How do I use the User port? 


The User port allows us to use a parallel port and different drivers for 
peripherals. Most of these drivers run using internal signals. So we are left 
with an 8-bit wide port and a "borrowed" controller. The controller is 
borrowed in the sense that the CIA 2 controls port A. 
The CIA 2 has its base address at 56576. That is also the location of the 
addresses for the data register for port A (Reg 0) where bit 2 1s the condition 
of the controller. All of the other controls are internal, therefore we can only 
use bit 2. 
Another method is to use register 1 (56577). This is the data register for 
port B—the single User port we can use. In this case we can use all eight 
bits in the register. The data control register follows the number 2 (56578 
for Port A [Caution—change only bit 2] and number 3 (56579 for Port B). 
To turn on all 8 data lines for programming use: 

POKE, -5969:/9;,255 
To turn off the data lines for input use only: 

POKE 56579;,-0 


When you are programming the controller you have to use some caution. 
To enable the input, type: 


POKE 56578, PEEK( 56578) AND 251 
To disable it again, type: 
POKE 56578,PEEK(56578) OR 4 


To write data out of this port we simply put the value in location 56577. The 
reverse allows us to read in values directly. 
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The port is opened to send or receive data by using: 


POKE 56576,PEEK(56576) OR 4 


and it 1s closed with: 
POKE 56576,PEEK(56576) AND 251 


If both commands are set directly from the program we can create a short 
pulse. 


The command control covers Pin M of the user-port (See Appendix 2 or the 
C-128 System Guide). The eight data lines are found on pins C through L. 
SUMMARY OF PROGRAMMING THE USER-PORTS 


Data control register for the 8 data lines : 56579. 
Data control register for control: 56578 (only bit 2). 
Data register for the port: 56577. 


Data register for control: 56578 (only bit 2). 
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12.3. Examples of applications 


The User port has many different applications. We won't give an example 
program for this section. However, we will give you a couple of 
suggestions to investigate. The simplest example uses lights or LED's, 
because they behave like transistors or relays: they're either on or off. You 
can make a light organ, where music 1s displayed by lights blinking on and 
off. With another program you can create more effects like this. 


It is conceivable to couple two Commodore computers (it doesn't make any 
difference what types as long as they are both using user-ports), to transfer 
data back and forth. It 1s possible to transfer VIC-20 data to a C-128 at the 
Same time the C-128 is displaying the input on its large high-resolution 
graphics screen. 


Modems can be built with a serial interface, so that data can be sent over 
telephone lines. Another possibility is the connection of non-Commodore 
computers to the C-128. This 1s also true for teletypes, card punchers or 
readers, home robots, or calculators. The number of possibilities for the 
hobbyist are endless. 
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BASIC and the operating system 


The operating system and BASIC offer us many commands that we have 
not detailed in any of the earlier sections. These functions (like LIST) are 
very helpful in accomplishing different tasks. We will discuss some of these 
possibilities in this chapter. 


13.1 Making BASIC line numbers for a program 


Let's say we want to write a program that will draw a graph of a function in 
high resolution graphics on the monitor screen. If there is a function the 
computer doesn't have, we must find a way of typing in the formula. One 
way 1S to allow the user to write a function in a specified program line using 
the function command DEFFN. For this the user must know how to 
program. It would be easier to be able to use an INPUT command to get the 
function. This means the input will be a string. Strings, of course, cannot 
be used directly to calculate values. The last possibility is to allow the 
computer to program itself. This turns out to be quite easy. 


To understand this method we will take a quick look at how program lines 
are normally used. It all begins when a user types in a series of numbers 
and letters. These characters appear on the screen. If one of these characters 
is a <<RETURN>, the BASIC-Interpreter puts the entire line (not just the 
typed-in characters) into an input buffer and changes the character sequence 
in a program line. Or if there is no line number at the beginning of the line, 
the BASIC interpreter directly executes the command. To use the interpreter 
then, it is possible to either type the lines or PRINT them. This is the basis 
for our method. Next, the text of the program line 1s output to the monitor 
screen. Now we only have to put a line number onto the beginning of the 
line. To do this we will use the keyboard buffer. We will put the 
ASCII-code in the keyboard buffer using a POKE. We follow this with an 
END. This causes two problems. By creating a new line in the C-64 mode, 
all the variables are reset (just like the normal program input). It 1s important 
to make a new line only at a point where no important data exists, like at the 
beginning of a program. If you have to save some variables, you can do this 
by POKEing the variables into free RAM. 
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Finally, the program should continue where it left off. This means we need 
a GOTO xxx line. This should follow the same pattern at the existing lines. 
Here 1s an example: 


10 INPUT "TERM: Y=";,AS: REM input function: 

20 PRINT "(CLS) (3xCRSR DOWN)100 DEFFN F(X)=";AS: 
REM output line number 

30 PRINT "GOTO 70(HOME)";: REM command to continue 
with the program. 

40 POKE 842,13: POKE 843,13:REM 2xreturn 

50 POKE 208,2: REM initialize keyboard input. 

60 END 


The following lines must be changed for the C-64. 


40: POKE 6315137 -POKE- 632,137 REM 2ereturn 
50 POKE 198,2: REM keyboard initialization 


If you type in this program and run it, you should begin to understand how 


ws tee 


Pe EE ps et Gera. Jamas Te APA 4 1 
you like. If you type something wrong, the interpreter will halt and print 


SYNTAX ERROR. 
This application can be expanded. With this method you can even get rid of 


program lines that you will no longer use. It is possible to put entire 
subroutines into a program using only INPUT commands. 
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13.2 Protecting listings 


It is possible to build code words for programs that contain personal data. 
The code word must not be LISTable. To protect these lines we use a 
POKE command. 


To understand what we are going to do you should know a little about the 
format of the program line in memory. The first two bytes in the line are the 
pointer to the next line. The interpreter uses these bytes to jump from line to 
line. If both bytes are 0, there are no more lines in the program. 


After the pointer come two bytes with the line number. These are similar to 
the pointer. Finally we find the commands in interpreter code. The end of a 
line is represented by a null. We can trick the interpreter by using this 0. If 
we POKE this O directly after the line number, when the program is LISTed 
the interpreter believes this line is empty and goes on to the next (the pointer 
is Still ok). A GOTO 1s also unchanged, since the specific line in the text (the 
one being searched for) is still onented with these line numbers. The routine 
that gets the next command in a program doesn't do this, it simply jumps 
over 4 bytes after reaching a zero. So in order to use the command you have 
to type the 5 needed characters (but not acommand word). The first of these 
characters 1s written over the O, the rest are used as place holders. 


How do we know what bytes to overwnite? There 1s a trick for this too. We 
will build a STOP command before the protected line and let the program 
run up to this point. After the BREAK the pointer to the next command is in 
locations 61 and 62. If the STOP command is at the end of a line, the 
pointer points to the O byte at the end of the line. If you add 5 to this 
address, you will find the hidden bytes. To continue, use POKE AD, 0. 
After this command the LISTing will still only give the line number. The 
text is no longer being pointed to. Now we have to get rid of the STOP 
command. Here is a summary of the steps: 


1. Put a STOP before the line 
2. Put 5 colons before the next line of code (placeholder,code) 
3. AD=PEEK (4610) +256*PEEK (4611) +5 
(C-64: 61/62) 
4.POKE AD,0O 
5. Get rid of STOP command 
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If you want to protect the entire listing, the easiest thing to do is change the 
vector to the LIST routine in the zero page. By doing this the computer will 
not find the LIST subroutine. This vector is in locations 774/775. Using 
POKE 775,139 (C-64: POKE 775,1) this vector is broken. To restore 
the LIST command use POKE 775,81 (C-64: POKE 775,167). 
SUMMARY OF PROTECTING LISTINGS 
C-128: Turning on the protection POKE 775,139 
Turning itoff POKE 775,81 
C-64: Turning on the protection POKE 775,1 


Turning itoff POKE 775,167. 
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13.3. RENUMBER 


One of the most useful commands in BASIC 7.0 is RENUMBER. This 
command can also be simulated in the C-64 mode. 


As you learned in the last section, every program line begins with two 
pointers. The first points to the beginning of the next line, the second really 
isn't a pointer, it's actually the current program line number. If we add 2 to 
the address of the pointer we get the address of the next line number. Using 
this technique we can search for all of the line numbers and by using POKE 
we can change these numbers. Here is a program to do this: 


63900 BA=PEEK (43) +256*PEEK (44) 
63910 INPUT "Start#";SA: INPUT "Step size";SW 
63920 HI=Sa/256: LO=SA AND 255 
63930 A=PEEK (BA+2) +256*PEEK (BA+3) 
63940 IF A>= 63900 THEN PRINT "OK! ":END 
63950 POKE BA+t+2,LO:POKE BA+t3,HI 
63960 BA=PEEK (BA) +256*PEEK(BA+1): 
SA=SA+SW 
63970 PRINT SA "=" A: GOTO 63920 


This routine must be placed at the end of an already existing program, and 
run with RUN 63900. 


Line 63900 calculates the base address of the first line from the pointer to 
the start of BASIC. Line 63910 allows the user to enter the new starting line 
number for the program. If you want the program to start at line 10 and 
have all line numbers separated by 10, you should enter a 10 twice. 


Line 63920 calculates the high and low bytes of the new line number, line 
63930 has the old line number from memory. If this number is greater than 
or equal to 63900, then the renumbering program is ended, since this 
routine will not renumber itself. 


The next lines POKE the high and low bytes of the new line number into 
memory. 
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Finally, the base address of the next line has to be calculated. The line 
number is increased by the step size, and the numbering protocol 1s output. 
This protocol points each new line number to the old equivalent. We use 
this method so that the GOTO, GOSUB and other such jumping commands 
inside of the program are not changed. If you own a printer I suggest that 
you print this protocol , so that you can have it in black and white in front of 
you. To do this put the following at the beginning of the routine: 


OPEN 1,4: CMD 1 
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13.4 RENEW 


The NEW command is one of the most frequently used BASIC commands. 
By typing its three characters (and pressing <RETURN>) the programmer, 
who has worked very hard on a program, can lose all of his work because 
he forgot to save it. Fortunately, we have a program that can help avoid the 
NEW-catastrophe. 


The NEW command does not clear the program memory—it clears the two 
central pointers to the program. The first points to the starting point of the 
variables at the end of the program. After the NEW it will point to the 
program beginning for all new lines or variables. Since the pointer will be 
incremented after each new line, you cannot use any new commands after a 
NEW, if you still want to use RENEW. This includes typing a single character 
and getting a SYNTAX ERROR. 


The second pointer finds the first line of the program. It is located in 
addresses 45 and 46, (2049 and 2050, 7169 and 7170, or 16385 and 
16386: C-64). Now these contain nothing but zeros. This marks the end of 
the program. Therefore, there are two things for RENEW to do: 


1. Search for the first line. It is marked with a O. If this null is found, 
you have to add one to this for a pointer in the bytes 45 and 46 (2049 
and 2050 or 7169 and 7170: C-64) and POKE it into memory. 

2, Search for the end of the program The program end is found when 
there is a zero in the high byte of the pointer to the next line. If the 
end is found, add two to the address, this is the beginning of the 
variable region of the program. 

Here is an application for both modes: 


In the C-128 both operations can be operated from ROM routines. Type in 
the following instructions: 


POKE (PEEK (45) +256*PEEK (46)),1:BANK 15 
Silo: 20503 “SxS. 20354 


Type everything Just as printed. 
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The POKE command resets the pointer to the first line. The next SYS 
command calls the routine to calculate the new line pointers. This subroutine 
starts all over and calculates the pointer from scratch. If the last line 1s 
found, the pointer to the last byte of the program is in an internal register. 
From this the next ROM routine calculates the pointer to the end of the text 
(4624/4625). That's all there is to it! 


Before you try this trick, you have to pay close attention to everything. The 
POKE command has to always go directly to the starting byte of the 
program. If the pointer (bytes 45/46) is changed by something like a RESET 
or GRAPHIC or CLR, it must be Set to its old value before the RENEW. 
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13.5 RESTORE 


Perhaps you have faced the problem of getting data from the middle of a 
data line. This 1s no problem with BASIC 7.0, where we have the 
RESTORE line number command. In BASIC 2.0 there 1s also a useful 
command to do this. 


We can remedy this problem with a pair of POKE commands . To do this 
we must understand that the interpreter saves the address of the last DATA 
element in the zero page much like it does with line numbers. The line 
number is saved as a byte pair (like pointers) in locations 63/64. The 
address of the byte to the last element of the DATA elements is found in 
65/66. 


If we want to simulate a RESTORE, we follow the next steps: 


1. Read the data up to the needed element. If you want the 5th 
element you have to read the first 4. 


2. PRINT PEEK(63) ,PEEK (64) 


The numbers that appear represent line numbers. Take note of 
these. 


3. PRINT PEEK(65) , PEEK (66) 


We have to take note of these numbers too. We build a pointer to 
the byte after the last DATA element. 


4. POKE 63,1. number:POKE 64,2.number 
POKE 65,3. number:POKE 66,4.number 


These commands are used in place of RESTORE in a program that needs its 
data pointers reset to the point before the read. 


SUMMARY OF THE RESTORE 
The line number of the last DATA elements is in the memory 
locations 63 and 64. The address of the byte after the last element is 


in bytes 65 and 66. Both points can be changed with the POKE 
command. 
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13.6. Different tricks 


After a break in the program or an error occurs, the computer still points to 
the last line completed. If you hastily removed something from the screen, 
there is usually no way to get it back. In this case the C-128 has the system 
variable EL and in the C-64 mode the locations 59 and 60 are helpful. They 
will contain the last line number used. 


PRINT EL (or) 
PRINT PEEK (59) +256*PEEK (60) 


If you want to prevent a program from being changed and then saved you 
can use the following sequence: 


POKE 818,50 (C-128 mode) 
This changes the vector so that it no longer works for saving programs. 


Finally, here are some SYS locations with routines that could be helpful in 
programming: 


SYS 65499 sets the TIS to QQOQOOO. This is quicker than setting a new 
string. 


A nice way to end programs is to use SYS_ 19910 (C-128) or in the C-64 
mode SYS 42115 instead of END. This is a warm start of BASIC. This is 
the same as BASIC in the direct mode. READY will not appear and the 
cursor goes to the next line. 


If you want to reset the computer at the end of a program use SYS 57344 
(C-128) or SYS 64738 (C-64). 


If you want to turn on the C-64 mode without the over used phrase "ARE 
YOU SURE?", look into the command SYS 57416. 
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If you feel that 1 MHz is much too slow in the C-64 mode, then the 


following POKE should make you happy: 


PORE: 5329 07:25.5 


This turns on the 2MHz clock. If this 1s too fast use: 


POKE 53296,0 


SUMMARY OF TRICKS FOR THE OPERATING 


SYSTEM 


The last line number 1s in EL or memory locations 59 and 60. 


SAVE protection: POKE 818,50 


TIS settoO: SYS 65499 
END without READY C-128: SYS 
END without READY C-64: 
Reset C-64 mode: 


SYS 64738 


Reset C-128 mode: SYS 57344 
GO64 without control question: 
2-MHz operation: 


2-MHz operation off: 
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LOO LO 


SYS 422115 


SYS 074.16 


POKE 23296) 25.9 
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Introduction to machine language 


There are many publications that print programs for you to type in. Quite 
often these programs are written in machine language. This can look like 
gibberish to the beginning programmer. Machine language is not as easy to 
learn as BASIC, but it runs a lot faster and offers more possibilities to the 
programmer. For these reasons we are going to present the basics of 
machine language programming. After you are finished with this chapter 
you will know the basics of machine language programming and you will 
be able to understand how such a program works. You will also have the 
background to continue if you want. If you find that you don't like machine 
language it will not be a total loss. You can still use what you learn for other 
purposes, because languages like PASCAL or LOGO can also use this new 
information. 


We are going to discuss both machine languages in the C-128 (8502 and the 
Z80). 
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14.1 What is machine language all about? 


As you already know, machine language is the only way to program the 
processor directly, without the help of an interpreter or compiler. Because 
you are directly using the processor there are more possibilities for 
programs. 


Machine languages have different commands that can be used to perform the 
same operations of BASIC or other languages. You can group the 
commands into three categories. The easiest to understand for the BASIC 
programmer are the jump commands. These are similar to the GOTO or 
GOSUB commands. Other commands are for data manipulation (for 
example: Addition). The last group are for the operations that move data 
from location to location within memory. 


The first point we should make is that microprocessors do not have 
variables. They only know about the different memory locations and some 
internal registers. You are responsible for determining the difference 
between the data range and the program range of memory. As a general rule 
data can only be manipulated in the registers. 


A machine language command 1s always comprised of an operation code (or 
opcode). This 1s the ‘number’ of the operation. This opcode can be up to 3 
bytes for the Z80 (it is always 1 byte for the 8502). In addition, the 
command can have up to 2 bytes for data. The Z80 can theoretically have a 
command up to 5 bytes long. Practically, though, the largest command 1s 
only 4 bytes—the 3-byte commands only have 1 byte for data. The 8502 
commands can be up to 3 bytes long. 
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14.2 The clock 


Inside every computer is a small quartz clock (4, 2, or 1 Megahertz = 4, 2, 
or 1 million ticks or cycles per second). This clock is needed to synchronize 
the different IC's. If the clock wasn't there, data in memory could be sent to 
the processor when the processor isn't ready to receive it. The 
microprocessor can also operate on more data in a shorter period of time 
with the help of the clock. 
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14.3 The structure of a microprocessor 


Every microprocessor has internal registers where all of the operations take 
place. The most important register is the Accumulator. Most of the 
arithmetic and logical operations use the accumulator. The accumulator 
(short Acc or A) is an 8-bit register, it can therefore hold only 1 byte of data 
at a time. Most arithmetic operations use two operands (for example 
addition needs two numbers to add together). The first operand 1s in the 
accumulator, the second 1s in another register in the processor or stored 1n a 
memory location. After the addition the result is placed back in the 
accumulator. This is the same for all processors. 


Another register has the name F for the Z80 and P for the 8502. It saves 
different flags and these vary from processor to processor. Some 
processors have a flag shows whether or not the contents of the accumulator 
is QO or not. 


The 8502 has two index registers (X and Y) each with 8-bits. These are 
extremely versatile registers. 


REGISTERS 





DIAGRAM 14.3 


The Z80 has 6 more 8-bit registers with different qualities. Every two of 
these registers can be combined to form a 16-bit register. The pair HL is 
already a 16-bit register, it can be used as a 16-bit accumulator. This allows 
you to use larger numbers. 
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IX and IY are two index registers (each having 16 bits), that are pointers to 
the different locations in memory. Using these pointers it is easy to 
manipulate groups of data. We will explain how this works later. 


The 16-bit register SP has a special purpose. This register always points to 
the top element of the stack (SP stands for stack pointer). Whenever a new 
element is pushed onto the stack or an old element is popped off, this 
register 1s appropriately changed to point to the top. 


Finally, there are the I and R registers, which also have special purpoes. 


If that was not enough, there are the registers A through L. These have a 
secondary register that can be switched with the jump register. You can 
work with individual registers whenever you want. The secondary register 
acts as an inbetween register. 


These are all of the registers for the Z80 (see the appendix). In the next 
section we will go over how a command is actually run in the processor. 


The number of registers only says a little about the performance of the 


processor. The 8502 can use the zero page much more efficiently than the 
Z80. 
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14.4 The operation of the microprocessor 


Imagine that there is a machine language program in your computer's 
memory that is just waiting to be run. The processor must know where the 
program is in memory. There is a special 16-bit register for this purpose. 
This is the program counter (abbreviated PC). It has the address of the next 
command in memory to be executed. If this command is to be used, then the 
processor gets the contents of this address. After this byte has been brought 
into the processor, this register is incremented by one so that it points to the 
next command. At the same time the opcode 1s decoded. In other words, the 
microprocessor determines which command is to be executed. Some 
commands for the Z80 are composed of a few bytes (this means there could 
be as many as 256 commands). In this case, it is easy to decode since the 
bytes are all right next to each other (The PC always points to the actual 
location, since it 1s always incremented each time). Even so, the command 
could still have one or two bytes of data. These are also read in, but they are 
not decoded. They are stored in the specified registers, or are operated upon 
by the processor. 


If we still have to change the data (by addition for example) then the 
processor performs the operation and saves the result (perhaps in the 
accumulator ). Then the processor goes on to the next command. 

All of this does not happen instantaneously, for even electricity requires a 
certain amount of time to flow. Normally the Z80 takes a clock cycle to do 
things like get the opcode, decode it, perform the command, and save the 
result. More complex commands can take more cycles to operate. The 8502 
has a different architecture and everything operates on two clock cycles. 


SUMMARY OF THE MICROPROCESSOR'S 
OPERATION 


The PC always points to the location in memory of the next byte in 


the program. The data and the opcodes are read one after the other. 
The opcode is decoded and finally the command is performed. 
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14.5 The hexadecimal system 


Whenever you program in machine language you express all your numbers 
in the hexadecimal system. In contrast to our everyday decimal number 
system, the hexadecimal system has 16 digits (rather than 10). These are 
0-9 and A-F (for the values 10-15). This is the most frequently used 
number system, since the conversion from hexadecimal to binary is very 
easy. An advantage to the hexadecimal system 1s that each digit actually 
represents one half of a byte (four bits). The largest 2 digit hexadecimal 
number FF has the binary digit combination 1111 1111. This is the largest 
number representable by a single byte. It is easiest to work with a half-byte 
and convert it into a hex-digit. Here is a table for the decimal/binary/ 
hexadecimal number system equivalences: 


BIN DEC HEX 
OOOO 0 0 
0001 yt 1 
0010 Z 2 
0011 3 3 
0100 4 4 
0101 5 5 
0110 6 6 
O111 f 7 
1000 8 8 
1001 9 9 
1010 10 A 
1011 11 B 
1100 12 C 
een 13 D 
1110 14 E 
ee 15 F 


If you had the byte 1010 1011, this would have the hexadecimal equivalent 
$AB (1010=$A and 1011=$B). This also works in the opposite direction. 


To convert from hex to decimal values, change each hex-digit to its decimal 
equivalent. The rightmost digit is multiplied by the value 16“0=1, the 
second is 16%1=16, the third 16“°2=256, etc. Finally, all of these values are 
added together, and the result is the decimal equivalent. Here is an example: 


ABCD (The values 10,11,12,13,) =10*16%3+11*1642+12*16%14+13*16%0 
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In the reverse direction (decimal to hex) you can divide the number by 16 
and then convert the remainder to hex.Then repeat the process with the 
result. Continue to do this until the result is zero. Here is another example: 


5300/16 = 3312 Remainder 8-> 8 
3312/16 = 207 Remainder 0- > 0 


207/16 = 12 Remainder 15 -> F 
12/16 = O Remainder 12 -> C 
=> 53000(dec) = CFO8 (hex) 


There are calculators that have this special function of switching bases 
(dec->hex, hex->dec, etc.). Good assemblers also have this function. 


The C-128 has a similar function. The BASIC function DEC converts 
hexadecimal values into decimal values. Its syntax is PRINT DEC (value) . 
The C-128 also includes the HEXS function. Its syntax is PRINT 
HEXS (VALUE). 
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14.6 Binary arithmetic 


14.6.1 Addition 


There's no reason to be scared off by the binary number system—t differs 
from the familiar decimal system only in the way it represents the values. 
Other, than this different value representation, they function in the same 
manner. 


The sum of the zeros or a zero and a one (regardless of order) requires no 
carry to the next place. This is just normal addition. However, if we want to 
add 1+1, then we have the problem of a carry. In the decimal system this 
would have the result 2. However, there is no 2 in the binary system. We 
must then perform a carry to the next column: 


0 0 l 1 
+0 +1 +0 +41 


0 Nt 1 10 


It is just as easy to add together two byte values. Here you just add up each 
column, and make sure that you don't forget the carry: 


01101101 = 109 
00001001 = +9 

1 1 (carries) 
01110110 = 118 


In this case it 1s possible to add two ones together and have the carry enter a 
situation that already has two ones. This results in the situation 1+1+1=3. 
In binary this would 11 (this should already be clear). Examine the example 
below: 


10010011 
+ 11011111 
1 11111 (carries) 


101110010 
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This gives us a result that has 9 bits! The ninth bit is called the carry bit or 
the overflow bit. When this bit is set it indicates that the result of the 
two-byte addition is greater than the 8-bits can hold (0-255). If this is the 
case you must move up to 16-bit addition. There is no computer with only 
8-bit addition, since most applications require a greater number range. The 
problem lies in the fact that an 8-bit microprocessor can only handle eight 
bits at a time. If we need 2-byte long addition, then the processor must add 
each word together one after the other. Now the only problem we have is 
the carry bit from the addition of the low order byte. This is handled simply 
by transferring this bit (the most-significant bit from the first addition) as a 
carry to the least-significant bit of the high order byte. Here is an example: 


00110101 i0010011 
+ 10011011 11011111 
L111111 eae (carries) 


2 ee ee me oem oe os ee ee 


11010001 01110010 


The righthand byte you should recognize from the previous example. 


14.6.2 Subtraction 


Whenever a computer has to subtract one number from another, what it 
actually does is multiply the second value by -1, and then adds the two 
values together. This is because a computer can easily perform functions 
like addition or negation (or AND, OR, NOT, or XOR), but subtraction does 
not fit into this category. 


If you include negative numbers the range of numbers for a single byte is 
change from 0-255 or -127 to +127. The most significant bit (bit 7) 
changes the sign of the value. If it is set to 1 then the number is negative, 
whereas a 0 gives a positive value. Therefore, negating a value is done by 
simply setting bit 7. Here is an example: 


Q000000 1 
+ 10000001 


10000010 
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In the decimal system this would be 1+(-1) = -2, which is obviously 
wrong. For this reason, we use another method. This method 1s called 
twos complement. A byte can be converted to two's complement quite 
easily with a multiplication by -1. By doing this we invert all the bits and 
then we simply add a one to the result. 


Example: 01011011 
Inverted: 10100100 
+ 1 

10100101 


Using this scheme with 1-1 in the binary system we get: 


00000001 
+ 11111111 
11111111 (carnes) 


1 00000000 


As you can see there is still a carry. This is a result of performing 
subtraction. In this case we can ignore the final carry. If this were a 16-bit 
subtraction, then the previous two bytes are all zero. This gives us the result 
we would expect. It 1s important, 1f you are using 16-bit subtraction, to 
invert all 16 bits. Therefore, for a two-byte value of a -1 the binary two's 
complement version looks like: 11111111 11111111. If we overlook the 
carry bit now, we would get 11111111 00000000. This is wrong. 


Luckily, programming a subtraction is not this complicated. The subtraction 


command in both processors has this two's complement procedure built 
right into it. 


14.6.3 Multiplication 


In case you don't believe it, machine languages only have two arithmetic 
commands, these are addition and subtraction. All other commands are a 
result of using just these two base commands, mostly as subroutines. 
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Since we won't be going into the intricacies of each machine language 
(we'll save that for another book), we will only go over the simplest 
algorithm for multiplication. This is not a widely used routine, since it is not 
very efficient, but it does work. 


To calculate the product of x*n, 1s the same as adding x n-times. 
Obviously, this only works for whole numbers. For numbers with a 
decimal point, we have to use multiplication column by column, however, 
the same basic principle holds. 


Here is an example to better show what we are trying to Say: 


4*3 = 44444 = 12 


14.6.4 Division 


For division there 1s also a very simple algorithm. To divide x into n parts, 
you simply subtract n from x repeatedly. The number of subtractions it 
takes to get to the point where n 1s iarger than x 1s the integer portion of the 
division. Here is an example: 


10/3 =? 

10-3 = 7 count = l 
7-3 = 4 = 2 
4-3 = l = 3 


lI 
— 


=> 10/3=3 remainder 


This algorithm works since the machine language allows for so many 
possibilities. A calculator works on the same principle, where each time you 
press a key you are also running a subroutine (naturally, with much more 
efficient algorithms). 


From the four basic arithmetic operations you can perform higher functions 
like percentages, or the Sine function. You can actually perform all 
mathematical operations with the small functions AND-, OR-, XOR-, and 
the NOT- (In fact addition and subtraction are actually constructed from 
these functions). 
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14.7 How do comparisons work? 


Comparisons are not uncommon in BASIC. However, how can you 
perform comparisons with a machine language? Here is an example of how 
we can do this: 


A=-B (=) A-B=0 


AS you can see the comparison of 2 numbers (here A and B) can be made. 
The computer knows the two are equivalent since the result on the 
right-hand-side is 0. The O is the number in the microprocessor's internal 
registers which can be determined if it is there or not. This happens for each 
bit-pair, then all of the bit locations are OR'd together: 


bit-7 OR bit-6 OR bit-5 OR bit-4 OR bit-3 OR bit-2 OR bit-1 OR bit-0O. 


If all 8 bits are set to O, then the result is a zero. If only one bit pair has a 
result of one, then the result will be one. Now, with this information, the 
processor can determine if the numbers are equal or not. If we use the 
accumulator we can determine equivalence by looking at the Z flag (Set if 
the accumulator's contents are zero). 


For comparisons of greater and less than we will perform operations simular 
to those for equals. After the subtraction we see if the value in the 
accumulator 1s less than or greater than zero, this is checked in the sign bit. 


A greater than B (=) A-B > 0 (bit-7=0) 
A less than B (=) A-B < 0 (bit-7=1) 


The sign bit is displayed in the S-flag in the Z80 (S means sign). This can 


be checked easily with special commands. The 8502 calls this the N-flag 
(N=negative). 


173 


Abacus Software Commodore-128 Peeks & Pokes 


Another Z80 flag is called the P/V flag. In this book we will simply call it 
the P flag. Th P flag flag has two functions. It can tell the parity (even or 
odd—you do not need to understand what this means). The P flag can also 
describe whether or not the sign bit was changed during an arithmetic 
operation. 


The 8502 has a similar flag called V. This is also used for the detection of a 
change in the sign bit. 
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8502 machine language 


Now we are going to deal with al lot of technical information. Before we 
take our first steps in the fastest programming language in the world, you 
should take a look at the contents of the appendix. It describes all of the 
commands of the 8502. From these you should get a quick overview of 
what the language contains. Don't be alarmed—you don't need to 
understand everything. 


15.1. The first 8502 program 


We are going to use only addition and subtraction in this machine language 
program, since this 1s the easiest way to learn how the processor operates. 
We will begin with an addition program for two eight-bit numbers. 


We used to POKE the two bytes that we wanted to add in to memory. There 
is no doubt that in BASIC this is a very nice method. However, there 1s no 
INPUT command in machine language. 


The first principle of machine language programming 1s this: All data 
manipulations occur in the accumulator. For this reason the first value of the 
command must be loaded into the accumulator. We use the command LDA 
Snnnn. To clear the carry bit before any operation, we have to use the CLC 
command. Finally, we get to the addition command ADC Smmmm. This 
command takes the second number out of the memory location mmmm and 
adds it to the contents of the accumulator. The result is put back in the 
accumulator. 


To save this result we use the STA Sxxxx. This saves the memory location 
where it could be PEEK'd later. This completes the addition. All that 
remains 1s to return back to BASIC with RTS. 


The entire command would look something like this: 


LDA Snnnn 
CLC 
ADC Smmmm 
STA SXXXX 
RTS 


177 


Abacus Software Commodore-128 Peeks & Pokes 


These commands should be stored somewhere convenient in memory. Then 
we only need to remember where this place in memory starts. Luckily, the 
developers of the C-128 remembered to save a region in memory for 
machine language programs. It is in the range from 1300 through 17FF in 
BANK 0. It is easiest if the above program started at the first location 
(1300). 


To load this program we simply use the ROM program MONITOR. This is 
called by its name from BASIC. Type in the following: 


A 01300 LDA 17FD (CR) 


This will assemble the first command, and translate the entered program into 
memory location 1300. The cursor skips to the next line and prints another 
A and the address 01303. The previous line now contains the command 
itself and the translation in its numeric equivalent. 


All other programs are assembled in a similar manner. If you want to type in 
another program, all you need to do now 1s hit <RETURN> and the 
MONITOR exits the assemble mode. 


When everything 1s typed in, the screen should look something like: 


™Dm Sf AD ne 
Fu WIN fat AR 


7 LOOU00 00 00 OO 00 £8 


01300 ad fd 17 .lda S$17fd 
01308 18 cle 
01304. 6d te <7 @de -Siyvte 
O15 0s7 Sad f£ 17 sta S1iVJ£f£ 
0130a 60 rts 


oo WM WM Dp 


If you made a mistake in the program you can change it as you would a 
BASIC command. Just move the cursor back to the mistake and type over 
It. 


The program now 1s in memory . We only have to give the numbers to be 
added. The MONITOR also has another possibility. Type the following: 


M O17fd, O17ff 
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With this command the C-128 displays eight bytes in a single line. This 
should not disturb you since the only part we are interested in is the first 
three hex values. 


We will put the two numbers we want to add together (for example $38 and 
$05 (decimal 56 and 5) in the first two bytes. You can change the values 
once again just by moving the cursor and typing over the old values and 
pressing the <RETURN> key. 


Using the command X, we can turn off the monitor and start up our 
machine program using the command SYS 4864. 


If you made a mistake the cursor will disappear. In this case you will have 
to turn off the computer and then turn it back on again to Start it all over. 
Otherwise you can use the addition program in two ways: 

a. PRINT PEEK (DEC ("1L7FF") ) 


b. You can go back into the monitor and retype M O17FD,017FF. 
The third byte will have the result. 


You should run this program a few times with different operands, so that 
you better understand how this works. 
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15.2. The second step: 16-bit addition 


As we have already pointed out you will have to use 16-bit addition for 
larger values. If you don't, you will have to come up with other algorithms 
because of the small numbers available with 8-bit addition. Below we have 
listed a program that will add any 16-bit number to a given constant. The 
number must be in location 17FF (high byte) and 17EE (low byte). A 
16-bit value requires 2-bytes and two addition steps. Everything begins in 
the previous example with: 


LDA S17FE and 
CHG 


To add the constant we use ADC #lowbyte. This command doesn't get its 
value from an appointed location, but directly from the following byte (the 
constant). 


After this command the lower half of the result is finished. This 1s saved 
using the command STA $17FC. The carry is saved in the carry bit and 1s 
not cleared after loading the second half with a LDA $17FF. Now we can 
continue with a normal addition with ADC #highbyte. 


STA $17/FD saves the second part of the result. Finally we return to the 
calling program with the RTS command. Here is the entire listing: 


1300 LDA SI7FE 
1302 Cig 


1303 ADC #E8 
E305, SrA Sige 
1307 LDA “SL7PE 
1309 ADC #03 


rou eB SLA SLED 
130D sales 


In this case the constant is O3E8=1000 in the decimal number system. 
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15.3. Subtraction 


We have already discussed how subtraction with the carry bit and the 
computer commands work. Here is a short program listing (simular to 8-bit 


addition). 


1300 
L302 
1303 
L305 
307 


LDA 
SEC 
OBC 
STA 
RTS 


SLUFF 

(set the carry bit) 
S17FE (Subtraction) 
S17ED 


181 


Abacus Software Commodore-128 Peeks & Pokes 
15.4. Multiplication 


You should remember from section 14.6. that multiplication 1s simply a 
repeated addition. We will write a machine language subroutine for 
multiplication using this method. 


If we use this method, we can make use of the 8-bit addition we wrote 
earlier. We will start with this addition routine. 


If we multiply two 8-bit values we can get a result up to 16-bits long. The 
addition routine must be set up to add an 8-bit value to a 16-bit result. When 
this 1s done the carry bit must be added to the highbyte. It all happens like 
this: 


LDA S17FE (low byte of the result) 
Cie 

ADC Si7FC. (@=bit. addit ton) 

STA S17FE (save the result) 

LDA S17FF (high byte of the result) 


ADC #00 (add O and the carry bit) 
STA SLT7FF (save the result) 
RTS (end of subroutine) 


After this addition the result is in 17FE/17FF, the 8-bit number is in 17FC. 
Now all we need is the length of the loop.The length given 1s in the 
multiplicator in memory location 17FD. 


The simplest method to program a loop of variable length for each run of the 
program, is to use a Special register and decrement it by 1. When the 
register reaches zero, then the loop is ended. The best register to use for 
this purpose is the X register. At the beginning of the loop the register is 
initialized with LDX $17FD (location $17FD contains the size of the 
multiplicator). 


Now we get to calling the routine with JSR Saddition (replace addition 
with the location to jump to). After the call to the addition routine the loop 
counter has to be decremented (that is subtract 1 from this value). This can 
be done with the one byte command DEX. One thing to be careful 
about--this command will also change the Z- and N- flags. They tell us if 
the value in the X register is negative or zero. Remember, though, these 
control bits are not only for the accumulator. 
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The opcode table in the appendix describes what flags are changed by each 
command. The branching commands use these flags to control the 
branching. We will need such information to operate our loop. We should 
continue branching to the top of the loop until X=0. The command for this 
operation is BNE Saddress (BNE=branch on not zero to address). If the 
Z-bit 1s set to one, then the result of the last operation was zero. If Z=0, 
then the result was not zero. The BNE command checks this bit. If it 1s zero, 
then the program jumps to the address following the command. Otherwise 
the next command in line is performed. The branch commands use a relative 
addressing mode—that 1s, the distance to the jump location 1s known. This 
distance 1s automatically calculated in the monitor. One drawback to this is 
that the distance can only be one byte in size. This means we can only have 
a jump of up to 129 bytes forward and 126 bytes backward. At first glance 
this doesn't seem like very much, but in actuality you will seldom need any 
more than this. 


Before the loop begins, the two resultant bytes have to be cleared to zeros. 
See for yourself: 


1300 LDA #00 

1302 STA S17FF (clear 17FF) 

1304 STA S17FE (clear 17FE) 

1306 LDX S17FD (load X) 

1308 JSR S130E (call subroutine) 


130A DEX (decrement X) 

130B BNE $1308 (branch) 

L300. RES (end of main program) 
130E LDA S17FE (top of addition) 


L300! CEG 

PS dk ADC SLI EC 

1313 STA SLIEE 

1315- LDA-Si7EF 

1317 ADC #00 

1319 STA S17FF 

oe oS (end of program) 


As you can see, the branch command is just as easy to use aS a Simple jump 
command. 
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Programming the Z80 


So that you can learn the different machine languages independently, we 
will go over the same topics that we did for the 8502. Don't worry about 
learning one better than the other. 


16.1 The first Z80 program 


We will start this section by writing a very simple program. One of the 
easiest 1s an 8-bit addition program. 


First of all, our program must somehow receive the two numbers to be 
added together. There is nothing like an INPUT command in machine 
language—the computer must get its values directly from memory. That is 
the first problem of our program. We can use the command "LD 
A, (nnnn)" much like we used the PEEK in BASIC. It takes the contents 
of mnnn and puts them in the accumulator. 


Let's say we know where the second byte is located. However, we cannot 
bring it into the processor with a command like LD B, (nnn), since there 
is no Such command in the Z80 machine language. What we can do is use 
the HL register pair as a pointer to our second value. What we do is load the 
address containing our value with LD HL,mnnn. Notice that the nnnn is no 
longer in parantheses. This indicates that the address is directly loaded into 
HL (not the contents). 


The next command finally adds the two values together: ADD A, (HL) . Its 
meaning is to add the contents of the accumulator with the contents of the 
address stored in the HL register pair. The result is returned to the 
accumulator. If the result is out of the value range (0-255) then the Z80 sets 
the carry bit to 1. 


If we don't need to use the result in the accumulator, we can use another 
command to store the result back into memory, where we can use a PEEK to 
look at it later. This is done with LD (nnnn) ,A. This command works 
much like the LD A, (mnnn) but in reverse. 
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Finally, we end the program with JP FFEO. This jump turns the 8502 
back on, which is the processor which BASIC uses. 


So far we have been programming with random locations. In our example 
you can use the addresses you want. All you have to do is make sure you 
are not using a region which the computer has to use for other purposes. 
For this reason we put the program in the free region of RAM from 1300 
through 17FF. The data bytes are at the end of this region. 


This is how our program looks: 


Address Command Comments 
1700 LD A, (17FF) Load first value 
1703 LD HL,17FE 2nd number in 17FE 
1706 ADD A, (HL) Add Acc and 17FE 
1707 LD (17FD),A Save result 
L70OA JP FFEO End of program 


If you look at the addresses you can see that different commands take up 


different amounts of memory. Commands using an address have at least 3 


bytes. Others, like ADD A, (HL), use only a single byte. 


Before you can POKE these bytes into memory, you have to know what 
they look like. In the appendix with the Z80 commands you can get a list of 
all of the opcodes. The opcode for LD A, (nnnn) 1s 3A and the two 
address bytes. Notice that the low byte always appears before the high byte. 
The complete command looks like: 


3A FF 1/7 
Here are the codes for the rest of the program: 
21 FE 17 + #4(LD HL,AB7E) 
86 (ADD A, (HL) ) 
32 FD 17 4(LD (ABT7D),A) 
CS. -BO FF (JP FFEQ) 


These values have to be POKE'd into memory. This can be done with the 
following BASIC program: 
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0 BANK 0 
1 PORE. ‘6591871952 POKE 65519;,002 .POKE ‘65520;.23 
2 POKE 65500,88:POKE 65502, 96 
QO FOR I=DEC("1700") TO DEC("170C"): READ AS: 
POKE 1I,DEC (AS) :NEXT 
20 DATA US Peet eg eg ee Ee ga ay 
MOO ge gE Dg dy ap CS pe AO ep Ee 
30° .INPUr “Hip 42"37 1,72 
40 POKE DEC("17FF"),Z1:POKE DEC("17FE") ,22 
50 SYS DEC("2000") :PRINT PEEK (DEC ("17FD") ) :GOTO30 


Before we can Start our routine we must tell the Z80 where our program is. 
The Z80 will look for the program's starting address in locations 
FFEE/FFEF. Line 1 sets the starting point at location 1700. Location 
FFED must have the value C3 which is the opcode for the jump instruction. 
Line 1 also takes care of this. 


We use an 8502 routine to start up the Z80 processor. This routine is 
already in memory Starting at location FFDO. However, we must set 
locations FFDC and FFDE with the values of 58 and 60 (hex) to return to 
BASIC when the machine language routine 1s finished. Line 2 POKEs these 
in for us. 


Lines 10 and 20 load our Z80 routine into the memory Starting at location 
1700. 


Line 30 simply INPUTs the two numbers to be added. Line 40 POKEs the 
two numbers into the locations in which our Z80 program will look for 
them. 


Line 50 contains a SYS command that starts the 8502 routine which in turn 
will start the Z80 routine. When control is passed back to BASIC, line 50 
PEEKs location 17FD and prints the answer that 1s stored there. For a more 
detailed explanation of this type of program see the book 128 Internals from 
Abacus Software. 


The subtraction program is almost exactly the same, except you have to 
change the ADD command to a SUB (HL). In the line 20 change the 7th 
value from 86 to 96. 
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16.2 How to program a loop 


In BASIC if you want to perform a section of code more than once, you 
have two choices: a FOR-NEXT loop or a DO-LOOP. There is a third 
possibility bu it 1s not as nice and is not used as often. After each pass we 
add one to a loop variable, and use an IF-THEN to jump back to the 
beginning, 1f needed. No matter how difficult this is, this is the only way to 
write a loop in machine language. Instead of a variable we use a register. 
The loop count 1s put in this register and decremented each time through. 
The following program does nothing more than loop 255 times. We haven't 
given you the BASIC program to load this program into memory, since this 
is fairly easy to do. This machine program executes so quickly that the loop 
is finished in less than a second. Here is the program: 


700: Db: By EE Load the loop size 
1702 DEC B Decrement counter 
LIOS JP NZ, 1302. Jump: Lo T3802 22 B<s0 
LPOG RET End of program 


The first command puts the loop size into register B. This number 1s built 
into the program, this is built right next to the opcode. You are probably 
asking yourself why we chose register B for the loop. Just as there are 
special commands for the accumulator, there are similar commands for the 
B-register. 


The DEC command (decrement = subtract by 1) subtracts one from the value 
in register B. When the result is 0, then the zero-flag is set to 1. Otherwise it 
remains set at 0. When the zero-flag 1s set to one the next command 1s 
performed, rather than jumping back up to 1302. JP NZ jumps to the 
address at the end of the command when the zero flag 1s not set. The next 
command is a RET, which ends the program. 
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16.3 More arithmetic routines 


16.3.1 16-bit addition 


As we Said earlier we can only use numbers up to 255 with 8-bit addition. 
With 16 bits this number is increased to 65535. While the Z80 only has an 
8-bit processor, it does have instructions for 16-bit arithmetic. It also has 
16-bit registers. 


For a 16-bit addition, one number must be in the register pair DE. This is 
done with the instructions LD DE, (nnmnn) where the byte nnnn is in 
register D, and E has the value at address nnnn+1. This is also in the pointer 
format (low/high). A similar instruction exists for the HL register pair. 


The addition instruction for 16-bits is ADD HL,DE. As you have probably 
already guessed, this instruction adds the two values in HL and DE and puts 
the result back into HL. After this step we can save the result in memory 
with LD (nnnn) ,HL. 


The entire program looks like: 


1700 LD DE, (17FE) 
1704: LD Hiss CL TEC) 
1707 ADD HL,DE 
1708 LD (17FA),HL 
170B JP FFEO 


Compare this with the same program for the 8502. 


Observe that each LD command requires two bytes. The loading program 
looks like this: 


O BANK 0 
1  POKE 65518,195: POKE 65519,00: POKE 65520, 23 

2 POKE 65500,88:POKE 65502, 96 

10 DATA VED a SOBs ge EE yp 

1k, DATA V2At "ey, 17% 

12 DATA. "19" 

iS: DATA Y227; A wT" 

ia: DATA. C34 SEO", MEE 
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20 FOR I=DEC("1700") TO DEC("170D") : 
READ A$: POKE I,DEC(A$): NEXT 
30 INPUT "#1, #2:";21,22 
40 POKE DEC("17FE"),Z1 AND 255: 
POKE DEC ("17FF") , INT(z1/256) 
50  POKE DEC("17FC"),Z2 AND 255: 
POKE DEC ("17FD") , INT8Z2/256) 
60 SYS DEC("FFEO"): 
PRINT PEEK (DEC ("17FA") )+256*PEEK (DEC ("17FB") ) 
70 GOTO 50 


This program works in the same way the 8-bit addition program worked. 
Only the machine language opcodes are different. 


16.3.2 Multiplication 


To multiply two numbers together we need to add a number over and over 
(ust like in section 14.6.3.). In BASIC the algorithm would look like this: 


10 INPUT "#1, #2: ";21,22: E=0 
2.0: FOR. T= ok “Gor 21 

30 BE = E+22: NEXT 

40 PRINT “results ";E 


As you can see, this program needs a single loop and an addition. We have 
programmed both before in machine language. 


The multiplication of two 8-bit numbers has a 16-bit result. This will work 
out fine with our 16-bit addition routine. 


Only the addition command has to be inside of the loop. All of the 
commands require that the values be stored in a register, or saved in a 
location in memory. Using the first command, the number 1 1s saved in the 
accumulator. Since the B register cannot get a value directly from a memory 
location, we store the contents of the accumulator into the B register, then 
put the second number into the accumulator and do the same thing with the 
E register. Now the loop is ready. The other 8-bit number is put in register 
pair HL. 
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The ADD HL, DE requires the D register to be set to 0 before the addition 
takes place. The HL register pair must also be set to 0 before the loop. 


The loop begins with the ADD command. The HL register is only changed 
with the ADD command, so it will always contain the result from the 
previous addition. 


The rest of the program is quite easy to figure out. DEC B and JP 


NZ,170D 1s the end of the loop, LD 


memory and JP FFEO ends the program. Here 1s the listing: 


The loading program follows: 


1700 
LTS 
1704 
1707 
1708 
170A 
LOD 
LTOE 
1712 
LL 


BANK 
POKE 
POKE 


DATA 

DATA "47" 

DATA 

DATA "5F" 

DATA "16", 
DATA "21", 
DATA "19", 
DATA. "C2", 
DATA "22", 
DATA "C3", 
FOR I=DEC ( 
READ AS: P 


LD A 
LD B 
LD A 
LD E 


LD D,0OO 


LD HL, OOOO 
ADD HL,DE 
JP NZ,170D 
LD (17FC) ,HL 


JP FFEO 


0 


65513,195: 


POKE 65519, 00: 


Number 1 

move it into B 

Number 2 

move it into E 

Clear D 

Clear HL 

Add130E DEC B decrement B 
Jump to 170D if B<>0 

Save result 

Return to BASIC 


PORE 65520;.23 


65500766 :PORKE. 65502;,96 
1 3A"; i Onl ca wy7" 


Ww 3A" ; wee Ww ; ve 17 Lh] 


woo" 


OO» roo" 


mog 


OD pL 
mY se Mee Ww 
a2 O hae wee 


17 OO") 
OKE I,DEC(AS): 


TO: DEC dL): 


NEAT 
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INPUT "#1, #2: ";21,2Z2 

POKE DEC ("17FEF"),2Z1: 

POKE DEC("17FE") ,Z2 

Sic. DECAY EEDO):* 

PRINT PEEK (DEC ("17FC"))+256* PEEK (DEC ("17FD") ) 


GOTO 30 


Once again only the opcodes have been changed. 


194 


Abacus Software Commodore-128 Peeks & Pokes 


16.4. How do we switch processors? 


You have probably already asked yourself how the operating systems work. 
Perhaps you have also noticed that the jump address for the Z80 routine at 
the end of the subroutine to turn on the 8502 is POKE'd. 


If you turn on one processor with the specified bits in the MMU, it is not 
very easy to turn off the other. Most likely, you are going to have to use a 
program to switch between the two. If we want to turn the processor back 
on later, we can POKE a Jump command in our program. 


For the 8502, we didn't have a JMP command, rather a CLI and an RTS. 
The CLI turns on the interrupts and the RTS command 1s for return back to 
BASIC. 


The switch always happens between BANK 0 and BANK 1, but it can only 
Switch operating system routines with POKE'S. 
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16.5. Final look 


Every processor like the 8502 and the Z80 has its strong points and weak 
points. The Z80 is better for operating on large blocks of data, whereas the 
8502 is good for programming in BCD-arithmetic. BCD means Binary 
Coded Decimal, where every character of a decimal number 1s a half byte. 
You need more memory (one byte requires a number from 0 to 99), but it 
can be more accurate in calculations, because it doesn't switch to a dual 
system. 


If you want to write a program in machine language you will need to decide 
which processor is better for what you want to do. 


Of course, you can switch in the middle of a Z80 program over to an 8502 
routine and use its operating system (even CP/M uses this principle). 
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Appendix A: 


Machine commands for the 8502 


ADC 
The data and the carry bit are all added together into the accumulator. This 
command effects the N,V,Z and the C(arry) flags. 


AND 
The input data is ANDed with the contents of the accumulator and the result 
1s returned to the accumulator. This command effects the N and Z flags. 


ASL 

The contents of the accumulator or a memory location are shifted to the left 
by one bit. The 7th bit is moved into the carry bit and bit 0 1s filled with a 
zero. This command changes the N,Z, and C flags. 


BCC dd 
If the carry bit is zero the processor jumps to the address given by the 
address of the next command plus the offset dd. No flags are changed. 


BCs: ad 
This is just like BCC, except the jump takes place when the carry bit is 1. 


BEQ dd 
Just like BCC, the jump takes place when Z=1. 


BIT 

The bits of a memory location are ANDed with the accumulator. The results 
are not saved, but if the result is not 0, then Z=1 otherwise Z=0. This is an 
easy way to test for equivalence. Outside of this both the most significant 
bits are stored in the flags N (bit 7) and V (bit 6). 


BMI dd 
Just like BCC, only jumps when N=1. 


BNE dd 
Just like BCC, only jumps when Z=0. 


Bris zdd 
Just like BCC, only jumps when N=0. 
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BRK 


Turns off the interrupts. This condition can be tested by checking if flag B 
is set to 1. 


BVC.-ad 
Just like BCC only jumps when V=0. 


BYVo: -dd 
Just like BCC only jumps when V=1. 


CLG 
Clears the carry bit 


CLD 
Clears the D flag. The result of this 1s to turn off the BCD mode. 


Cia 
Clears the interrupt flag. The result is that interrupts are turned back on. 


CLV 
Clears the V flag 


CMP 

The input data is compared with the contents of the accumulator. If all the 
bits are the same Z=1. If the contents of the accumulator are smaller than the 
input then N=1. The carry bit is set to 1 if the accumulator is greater than or 
equal to the input. This 1s a great help when you want to branch on a given 
condition. 


CPx 
Just like the CMP command, however, the input is compared with the X 
register. 


Cra 
Just like the CMP command, however, the input is compared with the Y 
register. 


DEC 
The given location is decremented by 1. This changes the N and Z flags. 


DEX 
Just like DEC, except the X register is decremented. 


De 
Just like DEC, except the Y register is decremented. 
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BOR 

This command takes the input data and XOR's it with the contents of the 
accumulator, the result is put back into the accumulator. The flags N and Z 
could be changed by this command. 


ING 
The input location 1s incremented by 1. The N and Z flags are changed. 


INX 
Just ike INC, except the X register is changed. 


INY 
Just like INC, except the Y register is changed. 


JMP 
The processor jumps unconditionally to the given address. 


JokK 
The processor jumps to a subroutine at a given address. 


LDA 
The accumulator is loaded with the contents of the given address. Flags to 
check are N and Z. 


LDX 
Just like LDA, except the X register 1s loaded 


Be 4 
Just like LDA, except the Y register 1s loaded. 


LSR 

The contents of the accumulator or a memory location are shifted to the nght 
by one bit. Bit 0 is shifted into the carry bit, and Bit 7 is filled with a zero. 
The N,Z and C flags are changed. 


NOP 
Waits for two clock cycles. No operation occurs. 


ORA 
The input data is ORed with the contents of the accumulator, and the result is 
placed in the accumulator. The N and Z flags are changed. 


PHA 
The accumulator is pushed onto the stack. 


PHP 
The flags are pushed onto the stack. 
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PLA 
The top of the stack 1s popped into the accumulator. Check the N and Z 
flags. 


PLP 
The flags are set by the contents of the top of the stack. 


ROL 

The contents of the accumulator or a memory location are rotated to the left 
by one bit. Bit 7 is copied into the carry bit, and also moves into bit-O. The 
flags N,Z, and C are changed. 


ROR 

The contents of the accumulator or a memory location are rotated to the right 
by one. Bit-O 1s copied into the carry bit and 1s moved into bit-7. The flags 
N,Z, and C are changed. 


Rif 
Returns from an interrupt routine, and restores the program counter and the 
contents of the flags. 


» 
we) 
et 
(‘= 
bt 
3 
” 
, 
it 
eo) 
i 
3 
9 
a 
= 
> 


routine, and returns the contents of the PC back to 


Just like ADC except this is subtraction. 


SEC | 
Sets the carry bit. 


SED 
Clears the D-flag. The result of this 1s to turn on the BCD mode. 


SE 
Clears the interrupt flag. The result 1s that interrupts are ignored. 


STA 
Saves the contents of the accumulator to a memory location. 


S'TX 
Saves the contents of the X register to a memory location. 


Sr 
Saves the contents of the Y register to a memory location. 
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TAX 
The contents of the accumulator are written to the X register. Check the N 
and Z flags. 


TAY 
The contents of the accumulator are written to the Y register. Check the N 
and Z flags. 


TSX 
The stack pointer is copied into the X register. The N and Z flags are 
changed. 


TXA 
The contents of the X register are written to the accumulator. The N and Z 
flags are changed. 


TXS 
The contents of the X register are saved in the stack pointer. 


TYA 


The contents of the Y register are written to the accumulator. The N and Z 
flags are changed. 
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Command 


ADC 
ADC 
ADC 
ADC 


Snnnn 
Snn 
#Snn 
Sinn 
Snnnn,yY 
ST Xx 
CSnns x) 
(San); 
Snnnn 
Snn 
#Snn 
Snp ni X 
Snnnn,yY 
Sy eeeuee.« 
(Snn,X) 
(Snn),Y 
A 
Snnnn 
Snn 
Snnnn,xX 
ST 
Sad 

S$ dd 

Sdd 
Snnonn 
Snn 

Sdd 

S dd 

Sdd 


Sdd 
Sdd 
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Appendix B: 


Opcode listing for the 8502 


Opcode Flags Description 

6DnnnnNV ZC Add contents of nnnn to accumulator 
65nnnn NV ZC Add location nn to accumulator 
69nn NV _ ZC Add byte nn to accumulator 
7DnnnnNV — ZC Add location nnnn to X-register 
79nnnn NV ZC Add location nnnn to Y-register 
75nn NV ZC Add location nn to X-register 

6Inn NV _ ZC Add byte from nn to X-register 
7inn NV _ ZC Add byte from nn to Y-register 
2DnnnnN Z ‘AND' nnnn with accumulator 

25nn N Z ‘AND’ location nn with accumulator 
29nn N Z ‘AND’ byte nn with accumulator 
3Dnnnn N Z ‘AND’ location nnnn with X-register 
39nnnn N Z ‘AND’ location nnnn with Y-register 
35nn N Z ‘AND iocation nn with A-register 
2inn N Z ‘AND’ byte with contents of X-reg. 
3inn N Z ‘AND’ byte from nn with Y-register 
OA N ZC Arithmetic shift left of accumulator 
OEnnnn N ZC Arithmetic shift left of location nnnn 
O6nn N ZC Anthmetic shift left of location nn 
1Ennnn N ZC Arithmetic shift left of nnnn+X-reg. 
l6nn N ZC Arithmetic shift left of nn+Y-register 
90dd Jump to PC+dd if C=0 

BOdd Jump to PC+dd if C=1 

FOdd Jump to PC+dd if Z=1 

20nnnn NV Z_ Test location nnnn 

24nn NV Z_ Test location nn 

30dd Jump to PC+dd if N=1 

DOdd Jump to PC+dd if Z=0 

10dd Jump to PC+dd if N=0 

OO Bl=1 — Software Interrupt 

5Odd Jump to PC+dd if V=0 

70dd Jump to PC+dd if V=1 

18 C=0Clear C 

D8 D=0 Clear D 

58 I=O0 Clear! 

B8 V=0 Clear V 
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CMP 
CMP 
CME. 


CMP 
CMP 
CUP 
CMP 
CMP 
CPx 
CEs 
CPX 
CPx 
Cex 
Cex 
DEC 
DEC 
DEC 
DEC 
DEX 
DEY 
EOR 
EOR 
EOR 
BOR 
FOR 
EOR 
FOR 
EOR 
INC 


LINC 
INC 


Snnnn 
Snn 


#Snn 
Snnnn,X 
Snnnn,yY 
Sry x 
(S$nn,X) 
eo 2epee ree 
Ssnnnn 
Snn 
#Snn 
Snnnn 
Snn 
#Snn 
Snnnn 
Snn 
Snnnn,X 
Sa eyoee A 
Snnnn 
Snn 
#Snn 
snnnns.X< 
Svanereeggamd 
Snny x 
(Snn,X) 
(Snn)y ¥ 
Snnnn 


Shin 
Snnnny x 


CDnnnnN 
C5nn N 
C9nn N 
DDnnnnN 
D9nnnn N 
DSnn N 
Cinn N 
Dinn N 
ECnnnnN 
E$nn N 
E0nn N 
CCnnnnN 
C4nn N 
COnn N 
CEnnnnN 
Conn N 
DEnnnnN 
Donn N 
CA N 
88 N 
4Dnnnn N 
45nn N 
49nn N 
5Dnnnn N 
59nnnn N 
55nn N 
4inn N 
S5inn N 
EEnnnnN 
E6nn N 
FEnnnn N 
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ZC Compare location nnnn with accum. 
ZC Compare location nn with accum. 
ZC Compare byte nn with accumulator 


ZC Compare location nnnn+X-register 
with accumulator 

ZC Compare location nnnn+Y-register 
with accumulator 

ZC Compare location nn+X-register with 
accumulator 

ZC Compare byte in nn+X-register with 
accumulator 

ZC Compare byte in nn+Y-register with 
accumulator 

ZC Compare location nnnn with X-reg. 

ZC Compare location nn with X-register 

ZC Compare byte nn with X-register 

ZC Compare location nnnn with Y-reg. 

ZC Compare location nn with Y-register 

ZC Compare byte nn with Y-register 

Decrement location nnnn 

Decrement location nn 

Decrement location nnnn+X-register 

Decrement location nn+X-register 

Decrement X-register 

Decrement Y-register 

Exclusive-or location nnnn with 

accumulator 

Exclusive-or location nn with 

accumulator 

Exclusive-or byte nn with 

accumulator 

Exclusive-or location nnnn+X-reg. 

with accumulator 

Exclusive-or location nnnn+Y-reg. 

with accumulator 

Exclusive-or location nn+X-register 

with accumulator 

Exclusive-or byte from nn+X-register 

with accumulator 

Exclusive-or byte from nn+Y-register 

with accumulator 

Increment location nnnn 

Increment location nn 

Increment location nnnn+X-register 


NNN N N N N N N N NNNNNNN 


205 


Abacus Software 


Commodore-128 Peeks & Pokes 





INC Snn,X Fonn N Z Increment location nn+X-register 

INX EA N Z Increment X-register 

INY C8 N Z Increment Y-register 

JMP Snnnn 4Cnnnn Jump to nnnn 

JMP $(nnnn) 6Cnnnn Jump to contents of nnnn 

JSR Snnnn 20 Jump to subroutine at nnnn 

LDA Snnnn ADnnnnN Z Load location nnnn into accumulator 

LDA Snn A5nn N Z Load location nn into accumulator 

LDA #S$nn A9nn N Z Load byte nn into accumulator 

LDA Snnnn,X BDnnnnN Z Load location nnnn+X-register into 
accumulator 

LDA Snnnn,Y B9nnnnN Z Load location nnnn+Y-register into 
accumulator 

LDA $nn,X B5nn N Z Load location nn+X-reg. into accum. 

LDA (Snn,X) Alnn N Z Load byte from nn+X-register into 
accumulator 

LDA (Snn),Y Blinn N Z Load byte from nn+Y-register into 
accumulator 

LDX S$nnnn AEnnnnN Z Load location nnnn into X-register 

LDX -Snn A6nn N Z Load location nn into X-register 

LDX #$nn A2nn N Z Load byte nn into X-register 

LDX S$nnnn,Y BEnnnnN Z Load location nnnn+Y-register into 
X-register 

LDY S$nnnn ACnnnnN Z Load location nnnn into Y-register 

EDY.-S7n A4nn N Z Load iocation nn into Y-register 

LDY #S$nn AOnn N Z Load byte nn into Y-register 

LDY Snnnn,X BCnnnnN Z Load location nnnn+X-register into 
Y-register 

LDY ny x B4nn N Z Load byte from nn+X-register into 
Y-register 

LSR A 4A N=0 ZC Logical shift nght of accumulator 

LSR $nnnn 4Ennnn N=0O ZC Logical shift nght of location nnnn 

LSR $nn 46nn N=0 ZC Logical shift nght of location nn 

LSR $nnnn,X SEnnnn N=0 ZC Logical shift nght of location 
nnnn+X-register 

LSR $nn,X 56nn N=0 ZC Logical shift nght of location 
nn+X-register 

NOP EA Wait 

ORA Snnnn ODnnnn N Z ‘OR’ location nnnn with accumulator 

ORA Snn OSnn N Z ‘OR’ location nn with accumulator 

ORA #Snn O9nn N Z 'OR' byte nn with accumulator 

ORA S$nnnn,X 1DnnnnN Z 'OR' location nnnn+X-register with 


accumulator 
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ORA 


ORA 
ORA 


ORA 


PHA 
ig Oa 
PLA 
PLP 
ROL 
ROL 
ROL 
ROL 
ROL 
ROR 
ROR 
ROR 
ROR 
ROR 
RTI 
RTS 
SBC 
SBC 
SBC 
SBC 


SBC 
SBC 
SBC 
SBC 
SEC 
SED 
SEI 
STA 


STA 
STA 


snnnn, 


Snny x 
(S$nn,X) 


(Snn) 5 


A 
Snnnn 
Snn 
Snnnn; x 
Snn,X 

A 
Snnnn 
Snn 
snnnn, X 
Snn,X 


Snnnn 
Snn 
#Snn 
Snnnn,X 
Snnnn,Y 
Snn,X 
(Snn, X) 


(Snn) ; 2 


Snnnn 
Snn 
Snnnin,x 


19nnnn N 
1Snn N 
Olnn N 
linn N 
48 

08 

68 N 
28 

2A N 
2Ennnn N 
26nn N 
3Ennnn N 
36nn N 
6A N 
6Ennnn N 
66nn N 
7Ennnn N 
76nn N 
40 

60 
EDnnnnNV 
E5nn NV 
E9nn NV 
FDnnnnNV 
F9nnnn NV 
F5nn NV 
Elnn NV 
Finn NV 
38 

F8 

78 I 
8Dnnnn 
85nn 
9Dnnnn 
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'OR' location nnnn+Y-register with 
accumulator 

‘OR’ location nn+X-reg. with accum. 
'OR' byte from nn+X-register with 
accumulator 

'OR' byte from nn+Y-register with 
accumulator 

Push accumulator onto stack 

Push status word onto stack 

Pop top off stack into accumulator 


N NN N 


Z 


NVBDIZC Pop top off stack into status word 


ZC Rotate accumulator to left 

ZC Rotate location nnnn to left 

ZC Rotate location nn to left 

ZC Rotate location nnnn+X-reg. to left 

ZC Rotate location nn+X-reg. to left 

ZC Rotate accumulator to nght 

ZC Rotate location nnnn to right 

ZC Rotate location nn to nght 

ZC Rotate location nnnn+X-reg. to nght 

ZC Rotate location nn+X-reg. to nght 
Return from interrupt routine 
Return from subroutine 

ZC Subtract location nnnn from accum. 

ZC Subtract location nn from accumulator 

ZC Subtract byte nn from accumulator 

ZC Subtract location nnnn+X-register 
from accumulator 

ZC Subtract location nnnn+Y-register 
from accumulator 

ZC Subtract location nn+X-register from 
accumulator 

ZC Subtract byte from nn+X-register 
from accumulator 

ZC Subtract byte from nn+Y-register 
from accumulator 


C=1 Set C-flag 


Set D-flag 

Set I-flag 

Store accumulator in location nnnn 
Store accumulator in location nn 
Store accumulator in location 
nnnn+X-register 
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STA Snnnn,Y 99nnnn Store accumulator in location 
nnnn+Y -register 

STA Sn, x 95nn Store accumulator in location 
nn+X-register 

STA (Snn,X) 8Inn Store accumulator in location 
nn+X-register 

STA (Snn),Y 9Inn Store accumulator in location 
nn+Y-register 

STX (Snnnin 8Ennnn Store X-register in location nnnn 

Six cnn 86nn Store X-register in location nn 

SUX. Shy Y 96nn Store X-register in location 
nn+Y-register 

Sty Sannn 8Cnnnn Store Y-register in location nnnn 

STY $nn 84nn Store Y-register in location nn 

STY “Snn7x 94nn Store Y-register in location 


nn+X-register 


TAX AA N Z Copy accumulator into X-register 
TAY A& N Z Copy accumulator into Y-register 
TSX BA N Z Copy Status into X-register 
TXA 8A N Z Copy X-register into accumulator 
TxXS 9A NVBDIZC Copy X-register into status 
TYA 98 N Z Copy Y-register into accumulator 
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Appendix C: 


Machine language commands for the Z80 


If you look at the opcode listing for the Z80 you will notice that there are 
many commands that only differ in the types of operands they use. These 
groups are described in this section. You don't have to learn all of the 
discrepancies, you can get a quick idea of what the groups are and all of the 
possibilities that they offer. Later, 1f you get into machine language 
programming you can use the opcode listing as a good reference. 


ADC A,X 

The operand x 1s added to the accumulator. The carry will also be set in the 
carry bit. The result is saved in the accumulator and the carry is saved in the 
carry bit. After this command all of the flags will reflect the contents of the 
accumulator. 


ADC HL,x 

This command functions in the same manner as the above only using 
16-bits. The operand x 1s added to the 16-bit register pair HL. The result is 
Saved in HL, and the flags are reflected as a result. 


ADD A,X 

The operand is added to the accumulator and the result 1s returned to the 
accumulator. The carry bit does not reflect the addition, however, all other 
flags will reflect the addition. 


ADD HL, x 
Just like the previous only 16-bit. 


ADD IX,x 

The operand is added to the index register, and the result is saved in the 
index register and the carry bit reflects the addition. The remaining flags, 
however, do not reflect the addition. 


ADD IY,x 
Just like the previous only with index register LY. 


AND x 

Logical AND of the operand with the accumulator, the result is saved in the 
accumulator. All flags reflect the operation and the carry bit 1s set to O (there 
1S no carry with an AND). 
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BIT n,x 

The nth bit of the operand x is tested. It is complemented and the result is 
placed in the Z-flag. If the bit is 1, then Z=0O, and if the bit was O then Z=1. 
The flags S and P contain also incidentally contain the value. 


CALL nnnn 
Call the subroutine at the address nnnn (this is similar to a GOSUB). 


CALL condition, nnnn 

The subroutine in nnnn is called if a condition is met. The condition can be 
the test of any of the flags S,Z,P, and C. Depending upon the state of the 
condition the processor will branch to the subroutine or continue on to the 
next command. 


CCF 
Complement the carry-bit. 


CE 26 

Compare the operand x with the accumulator. In other words, subtract and 
don't save the result, so that the accumulator will remain intact. If the 
operand is smaller than the eur then S=1, if it is preater than or 
equal to the accumulator, then S=0. If both values are equal then Z=1, 


som "F_f\ 
other wise 4-V. 


CPD 

The HL register 1s a pointer to a location which 1s compared with the 
accumulator. If both values are equal then Z=1. If the accumulator is 
greater or the same then S=0, ee S=1. HL and BC are then 
decremented by 1. If the contents of BC=Q, then the P-flag is set to 0, 
otherwise it remains set to 1. BC is used as a byte counter. 


CPDR 
Just like CPD, however it is repeated until a comparison reveals an equality 
(Z=1) or BC=0 (P-flag is set to Q). 


Cre 
Just like CPD, however, HL is incremented, not decremented. 


CPIR 
Just like CPDR, however, HL 1s incremented. 


CPL 
Invert all of the bits in the accumulator. 
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DAA 

After an arithmetic operation (ADC, ADD, DEC, INC, NEG, SBC, SUB) the 
existing false BCD digit is placed in the accumulator, and the flags are 
corrected. 


DEC xX 

The contents of the operand are decremented by 1 and re-saved in the 
operand. With the exception of the registers BC, DE, HL, IX, IY, and SP 
all the flags are set appropriately. 


DI 
After this command the Z80 ignores all maskable interrupts. 


DJNZ e 
The B register is decremented by 1. If B is not zero, then there is a relative 
jump to the address e. 


BE 
This turns the maskable interrupts back on. 


EX X,Y 
The two operands are exchanged. X can also be used for (SP). In this case 
the second operand will be exchanged with the top of the stack. 


EXX 
The register BC, DE,and HL is exchanged with the second register. 


HALT 
The Z80 stops the program until an interrupt starts it up again. 


IM n 
Turn off the interrupt mode. 
Mode 0: The next command is kept on the databus. 
Mode 1: The Z80 jumps to location 0038 (hex) and starts off the 
interrupt routine. 
Mode 2: Saves the lower half oi the address whose upper half is 


saved in register I. Below this address 1s the pointer to the 
interrupt routine. 


TEN: 2.CC) 
Register C has the port number where the byte is read into register x. 


IN A, (n) 
The accumulator is loaded from port n. 


TING. xe 
Just like DEC, however x 1s incremented. 
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TNT) 


Livni 


Register HL 1s the pointer to a location in memory where a byte from the 
port is saved. Register C has the number of the port. Outside of this HL and 
B are decremented. If B=0 then the Z-flag is set to 1. The flags (outside of 
the carry) reflect the command. 


INDR 
Just like IND except the command 1s repeated until B=0. 


INI 
Just like IND, except HL is incremented 


TINIE 
Just like INDR, except HL is incremented. 


vg? nnn 
The program jumps to address nnnn (similar to GOTO). 


JP condition,nn 
Jumps when a condition is true(for more information see CALL). 


JP X 
Jumps to the address in the operand x (HL, IX, IY). 


TD mn and TD AIAN ATEW 
Win £4 CLARA ULIN u 


Just like the JP commands, except the byte following the opcode is a 
relative address which is added to the program counter (PC). 


Ta)? ey 

This an belongs with most of the preceding commands, all of which 
follow one principle: The contents of the second operand will be transferred 
to the first. For example, when the contents of the accumulator are loaded 
into memory cell nnnn, or vice versa. The load command also applies to the 
16-bit register: Should a 16-bit register be transferred in memory, the low 
byte will be placed in nnnn, and the high byte into nnnn+1. This format is 
always used in computer science (Note: Low then high!) 


LDD 

HL and DE are used as pointers into memory. The contents of the HL 
register address are also stored into the contents of the address stored 1n the 
DE register. After this HL, DE, and BC are decremented. If BC=0, then the 
P-flag is set to QO. In this case BC can be used as a counter. 


LDDR 
Same as LDD, except it is repeated until BC=0. 
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LD1I 
Just like LDD, except the registers HL and DE are incremented. 


LDIR 
Just like LDDR, except HL and DE are incremented. 


NEG 

The byte in the accumulator is multiplied by -1. The result is saved in the 
accumulator. P=1 if the contents of the accumulator was $80 before the 
command, and C=1 if the accumulator had a O prior. 


NOP 
This command doesn't do a thing. 


OR xX 

This command OR's the contents of the accumulator with the operand. The 
result is found in the accumulator. After this the carry bit is set to 0, since 
there 1s no carry with a logical OR. 


OTDR 

HL 1s used as a pointer to a location whose contents are output to the port 
located in C. After this HL and B are decremented. This continues until B=Q. 
Outside of the C and the Z flags (set to 1) all flags represent the operation. 


Oo aR 
Just like OTDR except HL is incremented. 


OUT’ (Cy) px 
The operand x is output to a port which is located in C. 


OUT CA). . 
The accumulator is output to port n. 


OUTD 

HL is used as a pointer to a location whose contents are output to port C. 
Afterwards, HL and B are decremented. If B=0 then Z-flag 1s set to 1. All 
flags (outside of the carry flag) reflect the command. 


OUT. 
Just like OUTD, except HL is incremented. 


POP x 


The register pair in the operand 1s loaded with the contents of the top of the 
stack. AF stands for the accumulator and flags. 


213 


cs Fe) 


Abacus Software Commodore-128 Peeks & Pokes 





PUSH x 
The register pair in the operand is pushed on to the top of the stack. 
RES 1,X 


The nth bit oi operand x 1s cleared. 


RET and RET condition 

oe command 1s the return jump from a subroutine to the calling routine 
(similar to RETURN in BASIC). The condition can be true if a flag has a 
specific value. 


kk ie un s 
Return jump from an interrupt routine (similar to RET). 


RETN 
a NA 


Return jump trom an NMI routine 


Ru & and RLA 

The operand x is rotated to the left, where the carry bit 1s bit O and bit 7 1s 
what the carry bit was. The RL command changes all flags.The RLA 

command (not RL A). This operates much like RL A, except that it only 

influences the carry bit. 


pay 


PLC x» and RL 


WwW New Ae 
ao annararnaA ratateri ¢ vs 
Ww Vpes aii ces H S ROPE LY i Nee 


~ 
/ 
em 
pe et 
beet 
v 
fo mend 
Cv 
aoe, 


ft, where bit-7 1s moved into the carry bit. 


: by Vy atiweiw Wa Aid ABh 


(see appendix). Except for RLCA all flags are changed. 


RLD 

This command 1s a BCD rotation, the left half of a memory location whose 
address 1s in HL, is put in the right side of the accumulator. The right half of 
the memory location is put in the left hand side, and the right side of the 
accumulator is put in the right half of the location. The flags ‘S, Z, and P are 
influenced. 


RR x and RRA 
This command functions much like RL x and RLA, except the rotation 1s to 
the nght. 


RRC x and RRCA 
Just ike RLC x and RLCA, except the rotation 1s to the nght. 


RRD 

Just like RLD, except for a right rotation. The lower accumulator nibble (a 
nibble is one half a byte) 1s switched into the upper nibble of a location in 
the HL register. The upper location nibble is put 1n the lower and the lower 
location nibble is put in the lower half of the accumulator. 
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RST n 
Call to a subroutine at address n. 


SBC A,X 

The operand in x is subtracted from the accumulator, and the carry bit 1s 
changed. The result is left in the accumulator, and the new carry bit is 
saved. After the command all flags are representative of what happened. 


SBC HL, x . 
This command functions like the last except for a 16-bit subtraction. The 
result is saved in the HL register pair. 


SCF 
Set the carry bit. 


SEP. yx 
Set the nth bit of the operand x to 1. 


SLA xX 
The operand is shifted to the left. Bit 0 1s set to O and bit 7 moves into the 


carry bit. 


SRA xX 
The operand is shifted to the right. Bit 7 remains the same and bit-O is 
moved into the carry bit. 


SRL xX 
The operand is shifted to the right, bit-7 1s set to 0 and bit O 1s moved into 
the carry bit. 


©UB X 
The operand is subtracted from the accumulator. 


XOR X 
The operand is exclusive-or'd with the accumulator. 
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In the following table are all of the commands for the Z80 with their 
opcodes. The column for flags 1s a listing of all flags that could be changed 


by the command. 


Mnemonic Opcode Flags Description 

ADC A,A SE > 2 Pe Add carry andaA 
into A 

ADGA, B 88 5 Z4PC into B 

ADC A,C 89 S 24 P € at on cre ae @ 

ADC 21D BA Coe PoC into D 

ADC A,E 8B SZ. POC into: E 

ADC A,H SC Se Pec Lito: 7A 

DDC Ait 8D Se Pc into: 1 

ADC Agni CEenn So, © to the next 
Byte 

ADC A, (HL) 8E Sm ae me © to address in 
HL 

ADC A, (IX+d) DD8Edd Soo to address in 
IX+a 

ADC Ay (TY+d). FDSEdd SZ PAC to address in 
TY +a 

ADC HL,BC ED4A SZe IPE Add Carry and HL 
into: BC 

ADC. Hl; DE ED5A S..2-2 into DE 

ADC HL,HL BD6A {Ze Hee into HL 

ADC HL,SP ED7A SG Pe into SP 

ADD A,A 87 SGP Ae Add accum. into 
accum. 

ADD A,B 80 > £& PC into B 

ADD A,C 81 S2Z2PC IIo: °C 

ADD A,D 82 SZPC into. D 

ADD Aj 83 > 2 Pe into: E 

ADD A,H 84 SZPC into H 

ADD A, L 85 So: a Pv shig net o ame) 

ADD A,n Conn SS. ZR Co Che: next 
Byte 

ADD: 7yy- CHI) 86 S 4 bv to address in 
HL 

ADD A, (IX+d) DD8&6dd Sa ae ae © to address in 
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ADD A, (1Y+d) 


ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
AND 


AND 
AND 
AND 
AND 
AND 
AND 
AND 


AND 
AND 
AND 
Bay 
Bie 
(a el 
Bi 
BIT 
Bik 
Bit 
Bil 
Bie 
BIT 
BIT 


BIT 


HL,BC 
HL,DE 
HL, HL 
HL, SP 
IX,BC 
IX,DE 
1X, He 
IX, SP 
IY,BC 
IY,DE 
TY ,HG 
IY, SP 
A 


St mruoO Ww 


O, (IX+d) 


Cir Ge ok 


1,A 


nas 


FD86dd 


09 
dl, 
29 
32 
DDOY 
DD19 
DD29 
DDS 
EDO9 
EDAQ 
FDZ9 
BY39 
A7 


AO 
Al 
A2 
A3 
A4 
A5 
Eonn 


96 


DD9Y6dd 


FD96dd 


CB47 


CB40 
CB41 
CB42 
CB43 
CB44 
CB45 
CB46 


DDCBdd46 


FDCBdd46 


CB4F 


CB48 


Oo. hy eB ve 


NANNNNANN WY 


1 


Cp) 


N 
rd 


NNNNNNN 
Un OO sO O AC RA) 
MQQQMaaqaqa 
Sees 


NNNNNNWN 


29) 


pag 


MOQOAQQAAAADAANRAANAND 


=0 


to address in 
TY+d 
Add HL into BC 
INCO: WDE 
into HL 
Ln: SP 
Add IX into BC 
into ‘DE 
Int Ox Hs 
; into SP 
Add IY into BC 
INO. DE 
into HL 
into SP 
accum.with 
accum. 
with B 
with C 
with D 
With E 
H 
L 
ie 


"AND! 


with 
with 
with 
BYte 
with 
in HL 
with address 
in IX+d 
with address 
in IY+d 

Test Bit O of 
accum. 

Test Bit 0 of B 
of 
Or 
of 
enig 
of 
of the 
address 
of the 
address 
of the 
address 

Test. Bat 1 if 
accum. 

Test Bit 1 of B 


he next 


address 


sae 2 Om 6.2 a Oe 
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Bit ac CB49 Zs OL. 7G 

Bit 1.) CB4A Z of D 

Bal aes CB4B Z of E 

Bim boo CB4C Z of H 

BET ups CB4D Z of L 

Bad ods CHE) CB4E Z of the 
address in HL 

BIT 1, (IX+d) DDCBdd4E Z ... Of the 
address IXt+d 

BIT 1, (IY+d) FDCBdd4E Z Jing, OL the 
address IyYtd 

BIT 2,A CB5S7 Z Test Bit 2 of 
accum. 

BET 2B CB50 Z Test Bit 2 of B 

BIT 2iC CES] Z O£- *C 

BIT 2,D CB5Z Z, of D 

Bil 2) CB53 Z Or 

Bir “27.0 CB54 Z OL Hi 

Bae 2 CBD Zs of L 

Bit -23- (2) CB56 Z of the 
address in HL 

BIT 2, (IX+d) DDCBdd56 Z oy OL. the 
address IxXt+d 

BIT 2; (1Y4+d) FDCBdd56 Z ew. OL. ENS 
address IY+d 

Biv 2.5 CB5F Z Test Bit 3.68 
accum 

Bit 348 CBSs Z Test: (Bat .3. (Or 8 

Ba S40 CB59 Z Of °C 

BEY 32) CBoOA Z of D 

Bet S30 CB5B Z of E 

BIT 3,H CB5C Z of FH 

BED 3 CB5D Z Of iL 

BI? 3, (ai) CB5E Z of the 
address in HL 

Bilt 3;-CiXtd)- DDCBdd5E Z iaw 9OL: ie 
address IxX+d 

BIT 3, (1Y+d) FDCECdSE Z sem Of ENS 
address IY+d 

BIT 4,A CB67 Z Test Bit 4 of 
aceum 

BLY 4.3 CB60 Z Test Bit 4 of B 

BIT 4,C CBOol Z of C 

BiT 4,0 CB62 Z Of Dd 

Bik 455 CB63 Z of E 

Bo A CB64 Z of H 

BIT 4,L CB65 Z of L 
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——— SSeS SSS Ss SSS SSS 


BIT 4, (HL) CB66 Z, i24. Of he 
address in HL 

BIT 4, (IX+d) DDCBdd66 Z, the Of “Ene 
address IX+d 

BIT 4, (IY+d) FDCBdd66 Z »... Of the 
address IY+d 

j= Ud aes re CBOF L Test Bit. 5 of 
accum. 

BIT 5,B CB68 Z, Test Bit 5 of B 

Bre SC CB69 Z, of: 

BiT-5.D CB6A Z wie Je “D 

BIT 5,E CB6B Z te Of E 

BIT 5,H CB6C Z, of H 

BIT Of CB6D Z of L 

BIT (53-(HL) CB6E Z of the 
address in HL 

BIT 5, (IX+d) DDCBdd6E Z ... of the 
address IxXtd 

BIT 5, (1Y+d) FDCBdd6E L »». Of the 
address lY+d 

BIT -6;A CB77 Z, Test Bit 6 of 
accum. 

BIT 6,B CB70 L Test Bit 6 of B 

Bit 670 CB71 Z Of. ‘C 

BIT6;D CB72 Z tea, Jr ab 

Bit. (6;-E CB.i3 Z iit: 1OL-, 3 

BIT 6,H CB74 Z, of H 

BIT 6,1L CB75 L Of “Gh 

BIT 6, (HL) CB76 Z, of the 
address in HL 

BIT 6, (IX+d) DDCBdd76 Z, Lew Of the 
address IxXtd 

BIT 6, (I1Y+d) FDCBdd76 Z ... Of the 
address IY+d 

Bit Wek CB7F Z, Test Bit 7 of 
accum. 

BIT 7,B CB78 Z, Test Bit 7 of B 

BLT pC CB79 Zs of C 

BET iP CB7A L of D 

Bit’ 728 CB7B Z of E 

BIT 7,H CBIC Z of H 

Bit J4.k CB7D Z, Of i 

BIT 7, (HL) CB7E Z, Of the 
address in HL 

BIT 7, (IX+d) DDCBdd7E Z ... of the 


address IxX+ad 
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Q 
as) 
DPRrmmAoUOW Pp 


GP. Hi) 
CPY <LX+O) 
CP Cix+d) 


Crp 
CPOE 


CPL 
CPE -LE 


CPi 
DAA 


DEC A 
DEC. 5 
DEC BC 
DECC 
DEC) 
DEC. .DE 
DEC E 
DEC: A 
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FDCBdd7E Z of the 
address IYt+d 

CDnnnn Call subroutine at 
nnnn 

DCnnnn Lt ‘Carry= i 

FCnnnn if S=1 
(minus) 

D4nnnn cae Be Carry=0 

C4nnnn ewer Ae USO 

F4nnnn Site: Ge sS=0: Colic) 

ECnnnn ice LE P=] 

E4nnnn . i Ee PHO 

CCnnnn $6. “Lb sZa 

3E C Complement Carry 
Flag 

BF S.-2:. PC Compare A with A 

B8 S Z4PC $e Wien Be 

BQ S ZPC with C 

BA S. Ze se Ce with D 

BB SiGe de with E 

BC SZ Boe with H 

BD S3Z Pee With Wh 

FEnn S 2 Pe with the next 
Byte 

BE S: 2p Bue with address 
in HL 

DDBEdd S: 4 IP C with address 
IX+d 

FDBEdd S24 PC with address 
Ly ec 

EDAS S ZP Compare & decrement 

EDB9 S Z P Repeat compare & 
decrement 

EDA] SZ oP Compare & increment 

EDB1 5.2 2B Repeat compare & 
increment 

2E Complement accum. 

Z7 SP Ar Pe Adapt accum. for 
BCD 

3D SZ 2 Decrement A 

05 S ZP B 

OB BC 

OD Sof: 2 ce 

1 S Z P D 

1B DE 

s88. Se Aa E 

25 SZ H 
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DEG: His 
DEC. 2X 
DES: ALY 
DEC L 

DEC SP 
DEC (HL) 
DEC (IX+d) 
DEC. CLY+d) 
bet 

DJNZ e 


EI 
EX AF,AF" 


EX DE, HL 
EX (SP) ,HL 


EX (SP),IX 
BA: (SP) y-LY 
EXX 


HALT 


IM 0 
IM 1 
IM 2 
EN. Ay CC) 
IN: A Cre) 
IN: Be (CC) 
IN ge) 
EN. Dg: CC) 
EN Bey CC) 
IN H, (C) 
IN L, (C) 
INC A 
INC B 
ENG” BC 
LNG 
INC D 
INC DE 
INC E 
INCH 
INC: Al 
INC IX 
ENC iY 
INC L 


DD2B 
FD2B 


35 


Db25dd 
FDSo¢dd 


10ee 


NNN 


ANNNNNMNMN 


MN 


Cp) 


N 
eS RRS mae, 


NNNNNNN WN 


N 
rg 


ED) FO: a a hg Fg 


a0) 
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HL 

IX 

IY 

L 

SP 

address in HL 

address IX+d 

...- address IY+d 

save Interrupt 
Decrement & Jump by 

() 0 
TUL Off anterrupt 
Exchange A/Flags 

with 2nd reg. 
Exchange DE and HL 
Exchange HL with 

stack 

IX 

IY. 

BC, DE; HE with 

2nd reg. 
Stop 280 with 

Interrupt 
Interrupt mode 0 
Interrupt mode 1 
Interrupt mode 2 
Read Byte from P 

Can A 

from Port ni 

in B 

in 

in 

in 

an 

te ee 

Increment 

B 

BC 


Et ee PC 


accum. 
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aT 


or 


(HL) 


(IX+d) 
(IY+d) 


DDD DD DD 
SOHtAOM) DW 


~ ™ 


= 
ys 


A, (BC) 


ee) 

34 
DD34dd 
FD34dd 
EDAA 


EDBA 


EDA2 


BDBZ 


DAnnnn 
FAnnnn 
D2nnnn 
C3nnnn 
G2nnnn 
F2nnnn 
EAnnnn 
E2nnnn 
CAnnnn 
EQ 


DDEY 
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SP 
address in HL 
address IxX+d 
»... address IYt+d 
Collect: witn 
decrement 
Repeat collect with 
decrement 
Collect. with 
increment 
Repeat collect with 
increment 
Jump: EO. Nr, LE -C= 
toe 1O- Dy eS 
CO hs. VeE:-C 
to nn 
to: nn; 2f° -2=0 
to nn, if S=0 
to nn, if P=1 
to nn, if P=0 
to nn, if Z2=1 
to address in 
HL 
to address in 
IX 
to address in 
LY 
Relative jump, if 
C=1 
cto PCte 
1£ C=0 
if Z2=0 
paw, Ak. Zed 
Load accum. with 
accum. 
with B 
with.-C 
with D 
with E 
with H 
with I 
with L 
Wisc. “6 
Byte 
with R 
out: -of 
address in BC 


he next 
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LD A, (DE) 1a Ace SOM AOE 
address in D&E 

LD -Ay-(H) vey vee OB OF 
aGdadress in HEL 

LD A, (IX+d) DD J Edd Sb MOT Oe 
address IxX+d 

LD A, (IY+d) FD7Edd ee er OTE SOE 
address IY+d 

LD: A, (ain) 3Annnn OUL. “Ge 

LD B,A 47) ee 'B with accum. 

LD B,B 40 Lee Wet B 

LD By Cc 41 bina Wee. 

LD. By D 42 ae Ie 

ED? Bek 43 See ae SW a 

LD B,H 44 tga WIE. 

LD B,L 45 eee Wee. A 

LD B,n QO6nn -.. With the next 
Byte 

LD By (hid) 46 ret, “COCR Or 
address in HL 

LD B, (IX+d) DD46dd ive. Oe. vor 
address IxX+d 

LD: By (LY *d) FD46dd See, OALe, Soe 
address IY¥+d 

iD: Bey nn OTe nnn Load BC with the 
next By es 

LD. BG} (nr) ED4Bnnnn sae. WER Donn. anc 
‘Dobe oa gt 

E> ye AF Load ‘Wat aceum. 

bp: -Cy.B 48 124. Wie. 1B 

LD eC 49 aa “Wee, =e 

LD CzD 4A eg: WES 

LD: 3a 4B fe I 

De 4c Sus “Woe A 

LD: CyG 4D Gay i We. ly 

ED Cyn OEnn -.. with the next 
syce 

bD: Cy (Hi) 4k bd ae TON AO 
address in HI, 

bore mm. cee DD4Edd Scaicat SOU. 
address lxX+d 

LD 2, CLY +o) FD4Edd ee JOU. ioe 
address IY+d 

LD D,A 5] Load: i) watch accum:, 

LD D,B e0. ie WL EY. 

LD? Die D3 eee WET NC 

LD:  DyD SZ Si x ee, 


Zo3 
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LD 
LD 
LD 
LD 


LD 


LD 


LD 


LD 


LD 


LD 
LD 
LD 
LD 
LD 


LD 
NAD, 


ati 


LD 
LD 
LD 
LD 
LD 
ii 
ii) 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 


LD 


Be ee.) 
Dp Ciera) 
DE,nn 


DE, (nn) 


HOH 2 PB 


a a a a | 


> fo WO we 


E, (HL) 
Epix ta) 


BE, (LY+d) 


Hock eteoe 


i i i, i, i, i, i | 


> hot eo Ow YY 


H, (HL) 
Hy Gixed) 
Ae (Atta) 


HL,nn 


DD56dd 
FD56dd 
ELilnnnn 


EDSBnnnn 


66 
DDoedd 
FD66dd 


Zinnnn 


Commodore-128 Peeks & Pokes 


with E 
with H 
with L 
Wath 
Byte 

Out Of 
address in HL 
Out. OF 
address IxXt+d 
Out of 
address IY+d 


Load DE with the 


NeXt Bytes 
with nnnn and 
nnnn+ | 


Load E with accum. 


with B 
with Cc 
with D 
with E 
with H 
with L 
with t 
Byte 

OE. Of 
address in HL 
Out. Or 
address IxX+d 
Out “Of 
address lIyY+d 


he next 


Load H with accum. 


with B 
WLth: -¢ 
with D 
with E 
with H 
with L 
with t 
Byte 

Out: OF 
address in HL 
Out. OF 
address IxXtd 
Out OF 
address lIY+d 


he next 


Load HL with the 


next. Bytes 
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Li, CHS) Tt 
LD (IX+d),A 
LD. <IX+a)75B 
BD ATE) 36 
LD: “CIXFQ) 5 D 
LD (IX+d),E 
Gb (Kad) 7. 
Ti CIC) gt 
LD (IX+d),n 
LD (IY+d),A 
ED CLY +d) 4B 
1D CYR.) ye 
LD. CIlY +a) 5-D 
LD CIi¥+d) 75 
LD CEhY +d) 73 
LD? ALYY oh 
bp {LY+ra) yn 
LD (nn),A 
LD? s(n) BC 
ED. 4{py)4DE 
LD (nn),HL 
ISD: “Chee ee 
taps WF ep 
LD (nn),SP 
LDD 

LDDR 

LD I 

LDIR 

NEG 

NOP 

OR A 

OR B 


S6nn 


Dp idd 


DD70dd 
DD71dd 
DD72dd 
DD73dd 
DDT 4ed 
DD75dd 
DD3¢6ddnn 


FD fad 
FD70dd 
FD71dd 
FD72dd 
FD73dd 
FD74dd 
FD75dda 
FD36ddnn 
S2nnnn 
ED43nnnn 
BEDS53nnnn 
22nnnn 
DOZZnnnnh 
FD22nnnn 
BDI snnnn 


EDA8& 
EDB8 


EDAO 
EDBO 


ED44 
00 
Bal 


BO 


with the next 


BYES 


with 
with 
with 
with 
with 
with 
with 
with 
Byte 


with 
with 
with 
with 
with 
with 
with 
with 
Byte 


Load address IxX+d 


accum. 


B 


C 
D 
H 
L 
t 


he next 


Load address IY+d 


accum. 


B 


C 
D 
E 
H 
L 
t 


he next 


Load location nnnn 


with accum. 


with 


C 


nonnt+l 


with 


E 


nnonn+1 


with 


L 


nnonnt+l 
and nnnnt+l 


with IX 


and 
with B 
and 
with D 
and 
with H 


and nnnntl 


with IY 


and nnnnt+l 


with SP 
Load and decrement 
Repeat load and 


decrement 


Load and increment 
Repeat load and 


increment 


Negate -accum. 


(NO operation) 


accum:. 


accum. 


with 


B 


with 
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LD 


LD 
LD 


LD 


TaD 


LD 


LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 


LD 


LD 


LD 


LD 
LD 
LD 


LD 
LD 


LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 


LD 
ED 


AiG (nim) 


aT gb 
Lx nn 


IX, (nn) 
ie Gg 0G 


Ys. (an ) 


ie EE eS ee 


ae me a a 8 ae 


2Annnn 


ED47 


DD2Z lnnnn 


DD2Annnn 


FD21innnn 


FD2Annnn 


OE 


DD6Edd 


FD6Edd 


ED4F 
F9 
DDF9 
FDEF9 
31 nnnn 


EDVBrAnnn 


O02 


Her 


Pe 


70 
pa. 
72 
7T3 
74 
To 


225 


Load 
Load 


Load 


Load 


Load 
Load 


Load 


Load 


Load 
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out of nnnn 
and nnnn+t+l 

I with accum. 
IX with the 
next Bytes 
out of nnnn 
and nnnnt+l 
TY with the 
next Bytes 
out of nnnn 
and nnnntl 
Li. With. accum:. 
with B 
with C 
with D 
with E 
with H 
with L 
WLeh: 
Byte 

out of 
address in HL 
out of 
address IX+d 
out of 
address IYtd 
R with accum. 
SP with HL 
with IX 

Wit {LY 

with the next 
Bytes 

out of nnnn 
and nnnntl 
address out of 
BC with accum 
address out of 
DE with accum 
address out of 
Hk with, accum 


he next 


with B 
Wath: -C 
with D 
with E 
with H 
with L 
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OR C Bl So Ze ee with C 

OR D B2 S 4 PC with D 

OR E B3 S 2 PS with E 

OR H B4 SZ2PC with H 

OR L B5 SL. -€ with L 

OR n Fo6onn Sane ae ae © with the next 
Byte 

OR (HL) BO SZ2PC with address 
an) His 

OR (IX+d) DDBédd oS 2 PS with address 
TX+d 

OR (IY+d) FDB6dda SZ2PC with address 
Lyd 

OTDR EDBB Sade we Repeat output and 
decrement 

OTIR EDB3 De arte Repeat output and 
increment 

OUT. {C)y A BD YS OULpUL Accum: LO 
FOr. 7G 

OUT (C).4-B ED41 B to Port C 

OUT “(ey sC ED49 CG £O: Port -C 

OUT (C),D ED oli LO: POFE °C 

OUT (Cy ack ED59 E. £0. POreE: CC 

OUT (C)5H ED61 BH EO: POL. Cc 

OUT C6 )4dc ED69 oo Te Or POR, 

OUT (n),A D3nn QUE pUL, @ccCums. LO 
FOr. 

OUTD E.DAB S22 Output and 
decrement 

OUT I EDA3 S 2. 2 Output. -and 
increment 

POP AF ial Get accum. & Flags 
from stack 

POP BC ea Get BC from stack 

POP DE Del Get DE from stack 

POP HL Bl Get HL from stack 

POP IX BAB sag Get IX from stack 

POP IY FDE1 Get IY from stack 

PUSH AF ENS Pusn: accum:, «.-Fiags 
on stack 

PUSH BC 5 Push BC onto stack 

PUSH DE Bee Push DE onto stack 

PUSH.HAis ED Push HL onto stack 

PUSH IX DDED5 Push IX onto stack 

PUSH: Ly FDE5 Push IY onto stack 

RES 0,A CB87 Clear Bit O of 
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RES 0,B CB80 Clear Bat. O-or B 

RES 0,C CB8l1 nk LOL: 

RES 0,D CB82 eee OED 

RES 0,’ CB83 jee: Sas 

RES. 20.48 CB84 wea “Or 

RES. (Oy i CBSO ian, “OL ds 

RES OQ, (HL) CB86 ioe OL The 
address in HL 

RES 0, (IX+d) DDCBdd86 fo.4: Ok the 
address IxX+d 

RES. O07 (1Y+0) FDCBdds6 ... of the 
address IYtd 

RES: yx CB8F Clear: Birt 2 Of 
accum. 

RES: iy B CB88 Clear Bit 1 of B 

RES: LC CB89 ime Hod se 

RES 1D CB8A = nies HO oD 

RES 1,E CB8B ... of E 

RES 15.4 CB8C are Owe oF 

RES: di CB8D its. IO 5 

RES 1, (HL) CB8E tee OL Lhe 
address in HL 

RES 1, (IX+d) DDCBdd8E ... Of the 
address IxXtd 

RES 1, (I1Y+d) FDCBdd8E (on (OL the 
address IYtd 

RES. 274 CBYY Clear Bit 2 of 
accum. 

RES 2,B CB90 Clear Bit 2 of B 

RES 2;-C CB91 ‘Wags. Od AC 

RES 27D CB92 sigan Oc sD 

RES 2,E CB93 a ete. Ode AG 

RES 2,H CB94 ed (OE A 

RE oy 2p CB95 Swe MOL JG 

RES: 257. (Hi) CB96 ... Of the 
address in HL 

RES 2, (I1X+d) DDCBdd96 ... Of the 
address IxX+d 

RES 2, (IY¥+d) FDCBdd96 sey. (OL “Ene 
address IY+d 

RES 3,A CB9F Clear Bit 3 of 
accum. 

RES 373 CB98 Clear Bit 3 of B 

Rio 24°C CB99 Gf Cc 

RES 340 CB9A of D 

REO: Sk CB9B of E 

RES 37H CB9C of H 
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RES .37L CB9D ie Ot 

Rio. oy. Chis) CB9E gunk (Ot Tene 
address in HL 

RES 3, (IX+d) DDCBdd9E tear OF "tite 
address IX+d 

RES 3, (IY+d) FDCBdd9E ~ee iOcs “ene 
address IY+d 

RES 4,A CBA7 Clear Bit 4 of 
accum. 

RES: 4;,.B CBAO Clear Bit 4 of B 

RES 4,C CBA1 scar HOE C 

RES 4,D CBA2 eeeae (OD 

RES 4,E CBA3 hs SO 

RES 4,H CBA4 tates 200k 

RES: 431 CBA5 2 eres “Oe. iu 

RE. 4.) (( HE) CBA6 ... Of the 
address in HL 

RES 4, (1X+d) DDCBddA6é nig, CO, “ENE 
address IXt+d 

RES 4, (1Y+d) FDCBddA6 ioe OL tne 
address IYt+d 

RES 5,A CBAF Clear Bit 5 of 
ACCUM. 

RES 5,B CBA8 Cléar Bit. 5 of B 

RES. 346 CBA9 Loe "Or C 

RES 5,D CBAA sk é- (OED 

RES: «Dip 55 CBAB tae. (Od - 1B 

RES (57-H CBAC Pe OL A 

RES 5,L CBAD sce. Tne, 

RES: OF (Hi) CBAF ... Of the 
address in HL 

RES 5, (IX+d) DDCBddAE eee Oe. Ere 
address IX+d 

RES 5, (1Y+d) FDCBddAE Ae OL Ehe 
address IYt+d 

RES 6,A CBB7 Clear Bae 6.0 
accum. 

RES 678 CBBO Clear Bit 6 of B 

RES “6C CBBi bres de “Ode 

RES 6,D CBB2 So 1D 

RES 6,E CBB3 sana: (Of “EB 

RES 6,H CBB4 ... of H 

RES: '64.45 CBB5 ite Oude ss 

RES: 6, (HG) CBBO ... Of the 
address in HL 

RES 6, (IX+d) DDCBddBé tvs OF “the 


address IxXt+d 


229 


Abacus Software Commodore-128 Peeks & Pokes 


RES 6, (I1Y+d) FDCBddBé ee OMe Ee 
address IlYt+d 

RES 7,A CBBF Clear Bit 7 of 
accum. 

RES 7,B CBB8 Clear Bit 7 of B 

RES 7,C CBB9 owe OF: iC 

RES 7,D CBBA sere. SOL D 

RES 7,E CBBB Sys On cE 

RES 7,H CBBC cen OL 

RES 7,L CBBD se HOE. 1 

RES 7, (HL) CBBE “ini Or sehe 
address in HL 

RES 7, (IX+d) DDCBddBE ies Oe . eye 
address IxX+d 

RES 7, (IY+d) FDCBddBE hae OME HES 
address IlYt+d 

RET C9 Return from 
Subroutine 

RET C D8 Return, if C=1 

RET M F8 £44. ue “Sd. 

RET NC DO ae EE C=O 

RET NZ CO nierues. ede 30 

RET P FO Mice 1 SHO 

RET PE E8 i646: 2 PS 

RET PO EO ... if P=0 

RET 2 Ges) .20 LE ZH] 

RETI ED4D Return fro 
PR oie —y er a bhexe 

RETN ED45 vbw SPO 


NMI-Routine 


RL A CB17 S24. PC Lert Totat von: :-of 
Carry & A 

RL B CB10 S 2.P C and B 

RL C CBl1l S24 Ee and C 

RL D CB12 S2PC and D 

RL E CBs Sit ie and E 

RL H CB14 S4PC and H 

RL L CBI5 S ZPC and L 

RL (HL) CB16 S2PC and address 
in HL 

RL (IX+d) DDCBdd16 S 2Z4PC and address 
IX+d 

RL (1L1Y+d) FDCBdd16 S ZPC ... and address 
IlY+d 

RLA La C wee cana. -acoum. 

RLC A CBO7 S2PC Lert rotation Of 
accum. 
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RLC B CBOO S 221 P< of B 

RLC C CBO1 oS 4 Pe of C 

RLC D CBO2 oS 2 Boe of D 

RLC E CBO3 S. 2. 2 € Of 75 

RLC H CBO4 S Z4PC of H 

RLC L CBO5 oe, Se cae © Ot” 1G 

RLC (HL) CBO6 SA: PC of the 
address in HL 

RLC (1IX+d) DDCBdd06 S ZPC of the 
address IX+d 

RLG. CLY+d) FDCBdd06 S 2. P.C of the 


address IlY+d 


RLCA 07 c »~.. Of accumMm. 

RLD ED6F SZ: 2 Decimal rotation 
left 

RR A CB1F SZ: Right: S2otation: of 
Carry & -acoum 

RR B CB18 SZPC and B 

RR C CB19 S 4 PC and C 

RR D CB1A S Z4PC and D 

RR E CB1B S: Ze © and E 

RR H CB1C © 2 PoC and H 

RR L CB1D S Bok C and L 

RR (HL) CB1E S24PC and address 
in HL 

RR (1IX+d) DDCBaAGLE: “S: .Z: ‘P°-C and address 
in IX+d 

RR (LY+d) FDCBdd1E S$ ZPC and address 
in, 1Y+d 

RRA 1F C ota “ANG. “Accum. 

RRC A CBOE Sof PG Right rotation. of 
accum. 

RRC B CBO8 S ZPC of B 

RRC C CBO9 SZ -P < Of 

RRC D CBOA S ZPC of D 

RRC E CBOB S& ZB. of. -E 

RRC H CBOC 5.24 Pe of H 

RRC L CBOD 5. 4. PC of L 

RRC (HL) CBOE > 2 Po of the 
address in HL 

RRC (IX+d) DDCBddOE S Z PC of the 
address IX+d 

RRC (1Y+d) FDCBQG0E S.:-2 PC of the 
address IY+d 

RRCA OF c 2a. OL ACCUM. 

RRD ED67 SZ P Decimal rotation 
right 
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RST 00 CT Call routine in OO 

RST. 0-8 Cr bee fe 

RST -0 De Se, ae. SO 

RST: 238 DF Sets. Gee eS 

RST 20 ar | gc. LY -20 

RST 28 EF ste JZ 

RST: 30 E'7 ae, ee 3-0 

Rot 38 FF SG it, LT. Se 

SBC A,A OF SZ. IC Subtract. Carry &@ A 
from A 

SBC: Ay B 98 S2PC Bi from 2@ecum 

SBC A,C 99 So «es C from accum 

SBC A,D 9A Sl 2 DY 2vom.aeecum. 

SEC. Pie 9B SZ PC BE from -accum: 

SBC A;o 9C SS) ZR H from accum. 

SBC A, L 9D Sao ee LL from -eaccum. 

SBC Fen DEnn 5S 42 C the next Byte 
from A 

SBC A, (HL) SE So 2.2 address in HL 
from A 

SBC A, (IX+d) DD9Edd S. 2 ee address IxXt+d 


from accum 


SBCA; tly+ra) -FPDSEdd Sf. 2 address IyYt+d 
from accum. 
SBC: His BC ED42 5S 4PC subtract. C & BC 
Lr Om tas 
obG Hi; DE ED52 5 2 PC DE. Ze rom. Hy 
SBC: ib ED62 Ss. BP € Bb: 2 2om A 
SBC HL, SP EDI Z S402 SP from HL 
SCE og C=1l. Set Carry-Bit. to 
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Appendix E: 


Memory map in the C-128 mode 


WonanmnR WN © 


Data control register for 8502 
Data register for 8502 

Bank for the monitor 

PC highbyte for monitor 

PC lowbyte for monitor 

Status byte for monitor 
Accumulator for monitor 
X-register for monitor 

Z-register for monitor 

Stack pointer for monitor 

Leading character flag 

Monitor column after last TAB 
O=LOAD, 1=VERIFY 

Input buffer pointer 

Flag for the DIM 

Variable type O=numeric, 255=string 
Variable type O=real, 1=integer 
Flag for list, data, garbage collection 
Pointer for FN, variable type for FOR 
Input flag O= INPUT, 64=GET, 152=READ 
TAN / comparison flag 

Status I/O device, flag for INPUT 
Line number of 2-byte address 
Pointer to string stack 

Address for temporary string 
Stack for short strings 

Help pointer 

Real result of multiplication 
Pointer to BASIC program start 
Pointer to BASIC variable start 
Pointer to start of BASIC fields 
Pointer to end of BASIC field+1 
Point to start of BASIC strings 
Help pointer for strings 

Pointer to end of BASIC strings 
BASIC line number 

BASIC program number 

Pointer for USING search pointer 
Status of DATA line 

Pointer to next DATA 

Vector fo INPUT routine 
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71/72 
73/74 
75/76 
T7178 
79 
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Variable name 

Pointer to last variable 

AND mask, pointer to LIST for FOR 
Memory for BASIC program pointer 
Mask for comparison 

Pointer fo FN and garbage collection 
Pointer for string comparison 

Flag for HELP and LIST 

USR vector 

Oldov 

Help pointer 

Repeat carry pointer, DIM pointer 
Carry pointer 

Help pointer 

Register for number exchange 
Pointer of decimal point 

Exponent 
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Appendix F: 


Memory map in the C-64 mode 


20/21 


23/24 
25-33 
34-37 
38-42 
43/44 
45/46 
47/48 
49/50 
51/52 
53/54 
55/56 
57/58 
59/60 
61/62 
63/64 
65/66 
67/68 
69/70 


Processor port data control register 
Processor port data register 

Unused 

Vector for floating point to fixed point 
conversion 

Vector for fixed point to floating point 
conversion 

Search pointer 

Flag for special pointer 

TAB column 

OQ=LOAD, 1=VERIFY last command 
Input buffer pointer 

DIM flag 

Variable type: FF=string, 0O=num. 
Variable type: 80=integer, 00=floating 
point 

Special pointer for LIST 

Flag for FN's 

Input: OO=INPUT, 40=GET, 98=READ 
Pointer for ARCTAN/last compare 
Topical file 

Integer number, (ex:addr, FRE (0) ) 
Vector for string stack 

Pointer to last string 

String stack 

Diverse pointer 

Arithmetic register 

Pointer to BASIC program start 
Pointer to variable start 

Pointer to field start 

Pointer to end of field 

Pointer to string start 

String help pointer 

Pointer to memory border 
Immediate BASIC line number 
Previous BASIC line number 
Pointer to next command for CONT 
Topical DATA line 

Pointer to next data element 

Pointer to last DATA/INPUT/GET 
Actual variable (2 letters) 
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TAZ 
73/74 
75/76 
Td 
78/79 
80-83 
84-86 
87-91 
92-96 
97-101 
102 

103 

104 
105-109 
110 

111 

112 
113-114 
115-138 


122/123 
139-143 
144 
145 


147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
1D>7, 
158 
159 
160-162 
163 
164 
165 
166 
167-171 
172/173 
174/175 
176/177 
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Pointer to actual variable 

Pointer for present FOR-NEXT variable 
Help register for BASIC program pointer 
Help register for comparison 

Pointer for F'N's 

Help register for strings 

Jump vector for function 

Arithmetic accumulator 3 

Arithmetic accumulator 4 

Arithmetic accumulator 1 

Pointer to accumulator 1 

Numbers for polynomial value 
Rounded byte for accumulator 1 
Arithmetic accumulator 2 

Pointer to accumulator 2 

Compare register for accumulator 1&2 
Rounding byte 

Pointer to polynomial value 
CHRGET-routine gets next byte from 
BASIC program. 

BASIC program pointer 

Last RND value 

Status (like variable ST) 

Flags for keyboard column 1146 time 


constant for cassette operations 
O=LOAD, 1=VERIFY 

Flag for IEC bus 

Pointer to IEC bus 

Flag for end of tape (cassette) 
Exchange location for register 
Digit of open file 

Current input device (normal:0) 
Current output device (CMD, normal:3) 
Parity byte for cassettes 

Flag for byte reception 

Output mode (128=direct,O=prg.) 
Proof sum in cassette operation 
Error correction for cassette 
Clock 

Bit count for serial output 
Counter for band operation 
Counter for writing to band 
Pointer in cassette buffer 

Flags for band operation 

Pointer to cassette buffer 

Pointer to program end (LOAD / SAVE) 
Time constant for cassette 
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178/179 
180 
181 
182 
183 
184 
185 
186 
187/188 
189 
190 
191 
192 
193/194 
195/196 
197 
198 
199 
200 
201/202 
203 
204 
205 
206 
207 
208 
209/210 
211 
212 
213 
214 
215 
216 
217-242 
243/244 
245/246 
247/248 
249/250 
251-254 
255 
256-511 
256-266 
256-318 
512-600 
601-610 
611-620 
621-630 
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Pointer to cassette buffer start 

Bit counter (cassette) 

Next bit for RS232 (sending) 
Output byte 

Character count in file name 
Current logical file number 
Current secondary address 
Current device number(8:floppy) 
Pointer to filename 

Help pointer for serial output 
Block count for band operation 
Word buffer for serial output 
Flag for cassette motor 

Start addres for LOAD/ SAVE 
End address for LOAD/SAVE 
Pressed key 

Digit of pressed key in buffer 
Flag for RVS 

Line end for input (pointer) 
Pointer for input cursor (line,col) 
Pressed key 

Flag for cursor (O=blinking) 
Count for blink time 

Character under cursor 

Blinking flag 

Flag for input of keyboard 
Pointer to actual monitor line 
Cursor column 

Type of cursor (program/direct) 
Length of screen line (40/80) 
Cursor line 

Last key 

Digit of insert 

High-byte of line start 

Cursor position in color ram 
Pointer to keyboard decode table 
Pointer to input buffer for RS232 
Pointer to output buffer for RS232 
Free bytes for operating system 
Start of the BASIC memory (*64) 
Processor stack 

Exchange register for format change 
Correction for band error 
BASIC input buffer 
Logical file numbers 
Device numbers 
Secondary addresses 
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631-640 
641/642 
643/644 
645 
646 
647 
648 
649 
650 


651 
652 
653 
654 
655/656 
657 
658 
659 
660 
661/662 
663 
664 
665/666 
667 
668 
669 
670 
671/672 


673 
674 


676 
677 
678-767 
704-766 
768/769 
770/771 
772/773 
774/775 
776/777 
778/779 
780 
781 
782 
783 
784-787 
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Keyboard buffer 

Pointer to BASIC-RAM start 
Pointer to BASIC-RAM end 

Flag for time error on serial bus 
Current character color 

Color under cursor position 

High byte of TV-RAM base address 
Maximum length of keyboard buffer 
Flag for repeat (O=normal, 128=all, 
127=out) 

Counter for repeat function 

Counter for repeat delay 

Flag for SHIFT,Commodore&CTRL 
Just like 653 

Pointer to keyboard decode table 
Flag for character exchange 

Flag for scrolling 

Control register for RS232 
Command register for RS232 

Bit time 

Status register for RS232 

Digit for output bit for RS232 

Baud rate for RS232 

Counter for reception byte RS232 
Counter for input of RS232 

Pointer to output byte for RS232 
Output pointer for RS232 

Exchange location for IRQ band 
operations 

NMI flag CIA 2 

Timer A of the CIA 1675 interrupt flag of 
CIA 1 

Flag for timer A 

Monitor line 

Free RAM region 

Sprite block 11 

Pointer for error report 

Pointer to BASIC warm start 
Pointer to exchange text/code 
Pointer to exchange code/text 
Pointer to command control 

Pointer to output value 
Accumulator for SYS 

X-register for SYS 

Y-register for SYS 

P-register for SYS 

USR-jump (address in 785/786) 
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788/789 
790/791 
792/793 
794/795 
796/797 
798/799 
800/801 
802/803 
804/805 
806/807 
808/809 
810/811 
812/813 
814/815 
816/817 
818/819 
820-827 
828-1019 
832-894 
896-958 
960-1022 
1023 
1024-2023 
2024-2039 
2040-2047 
2048-40960 
8192-16192 
40960-49151 
49152-53247 
53248-57343 
53248-53294 
53295-5427] 
54272-54300 
54301-55295 
55296-56295 
56296-56319 
56320-56335 
56320/56321 
56336-56575 
56576-56591 


565778&56579 


56592-57343 
57334-65535 
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Pointer to hardware interrupt 
Pointer to BRK interrupt 
Pointer to NMI 

Pointer to OPEN 

Pointer to CLOSE 

Pointer to character input 
Pointer to character output 
Pointer to channel clear 
Pointer to input 

Pointer to output 

Pointer to STOP key polling 
Pointer to GET 

Pointer to close all channels 
Pointer to user IRQ 

Pointer to LOAD 

Pointer to SAVE 

Free RAM region 

Cassette buffer 

Sprite block 13 

Sprite block 14 

Sprite block 15 

Free 

TV-RAM 

Free 

Pointer to sprites 

BASIC memory 

Bit map for hi-res graphics 
BASIC interpreter ROM 
4K RAM for machine program 
Character generator 
Register for the VIC 

977 bytes empty 

Register of the SID 

995 bytes empty 

Color ram 

24 bytes empty 

Register of the CIA 1 
Keyboard poll and joysticks 
240 bytes empty 

Register of the CIA 2 
USER-PORT register 

752 bytes empty 

Operating system ROM 
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Appendix G: 


VIC and VDC 


VIC: base address 53248 


REGISTER CONTENTS 

O-15: Sprite coordinates (X,Y) 
16: MSB of the Y-coordinate 
17: Control register 

18: Raster line for interrupt 
19/20: Light pen position (X,Y) 
21% Sprite enable 

22: Control register 

2D. Y-expansion 

24: Video-RAM/char-ROM control register 
25/26: Interrupt control 

21: Sprite priorities 

28: Sprite multicolor mode 
29: X-expansion 

30: Sprite/sprite collision 

31: Sprite/data collision 

OZ: Frame color 

33-36: Background color 0-3 
37/38: Multi-color for sprites 
39-46: Sprite colors 

(47): Keyboard control 

(48): 2-MHz control 
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VDC: Base address 54784 
54784: Register selection 

54785: Data transfer 

QO: Total count characters per line 
1: Count of characters per line 
213: Horizontal synchronization 
4: Total count of characters 

5: Vertical adjustment 

6: Count lines 

7: Vertical synchronization 

8 Interlace mode 

9: Raster line count 

10: Cursor mode 

WE Cursor size 

12/13: Video ram start 

14/15: Cursor position 

16/17: Light pen (X,Y) 

18/19: Update (HI,LO) 

20/21: Attribute (HI,LO) 

22: Brightness of characters 
23; Length of a character 

24: Vertical smooth scrolling 
ZS: Horizontal smooth scrolling 
26: Color 

27? Address increment 

28: Start character generator 
29: Underline character 

30: Word count 

31: Data 

32/33: Blockstart (HI,LO) 

34/35: Display enable 

36: RAMrefresh rate 
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Index 


accumulator (microprocessor), 164 
addition (binary), 169 
Z-80, 191 
address lines, 3 
animation (sprites), 95 
ASCII, 6, 38, 127, 135 
attribute RAM, 102 


BANK, 7, 10, 195 
bank switching, 24 
C-64 mode, 29 
base address, 18 
BASIC 7.0, 5-6, 147-157 
BCD-arithmetic, 196 
binary system and arithmetic, 169-172 
BIOS, 14 
bit, 3, 167 
bit-map graphics, 67, 68, 111 
BLOAD, 39 
branch commands (machine language), 183 
BSAVE, 37 
BUMP, 91 
byte, 3, 167 


C-64 mode, 11 
C-128 Internals, (Abacus), 6 
C-128 Tricks & Tips, (Abacus), 13 
Cadpak (Abacus), 77 
character generator, 53, 103 
character modes, 49 
CIA (Complex Interface Adapter), 13, 139 
CIA 1 (keyboard), 127 
CIA 2 (port A), 142 
clock, 163 
color RAM, 50, 58, 60, 67, 72 
COLLISION, 91 
comparisons (logical), 173 
Commodore 128 System Guide, 9,17, 23, 67, 89, 117 
CP/M, 14, 196 
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data bus 3 

Datasette, 61 

DEC, 104, 168 
DEFFN, 147 
division (binary), 172 


ENVELOPE, 121-122 

EPSON printer, 79 

envelope curve (SID), 117, 118 
extended color mode, 50 


FETCH, 2 
flags, 164, 183 
floating point accumulator, 8 
FRE (), 34 
frequency, 118 
graphics, 37, 67-85 

w/80 column screen, 109 
hexadecial system, 167 
HEXS, 168 
hidden point removal, 82 


index registers, 164 
Input/Output, 13 
interpreter, 3, 6, 28, 147, 155 
interrupt, 4 

raster line, 85 


keyboard, 127-136 
buffer, 4, 127 
codes, 136 
disabling keys, 132 
key-repeat, 134 
matrix, 129, 131 
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LIST protection, 149 
LOGO, 161 

loops, 190 

lowbyte, 18 


machine language, 4, 8, 161-196 
Z-80, 187-196 
8502, 177-183 
MCR register, 26 
memory, 3 
C-64 mode, 11 
C-128 mode, 13 
free areas, 34 
protection, 31-33 
merging, 40-42 
microprocessor, 3, 164-166 
accumulator, 164 
clock, 163 
MMU (Memory Management Unit), 11-14 
configuration register (CR), 24-25 
MONITOR (ROM program), 178 
MPS-801 printer, 79 
multi-color mode, 50, 67, 73 
multiplication (binary), 171 
Z-80, 192 
8502, 182 


N-flag, 173 


offset, 18 

operating system, 4 
operation code (opcode), 162 
overflow bit, 170 


page pointer, 28 

parallel ports, 139, 140-141 
PASCAL, 161 

PCR registers, 26 

PEEK, 7, 29 

pie charts, 76 
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pixels, 72 
multi-color mode, 73 
setting in C-64 mode, 72 
setting in C-128 mode, 112 
PLAY, 121 
pointer, 18 
polling (keyboard), 127, 129, 135 
POKE, 7, 29 
PRG files, 43 
Processor Stack, 20 
program counter (PC), 166 
program protection, 149-150 
projections (3-D), 81 
PRINT, 6 


RAM, 9-14 
configuration register, 27 

raster lines, 85 

RENEW, 153-154 

RENUMBER, 151-152 

RESTORE, 155 

RGB output, 101 

ROM (Read-Only Memory), 4, 9-10 
BASIC ROM, 11, 24, 29 
character ROM, 49 
functions, 25 


serial port, 139 

SID (Sound Interface Device), 13, 117 

sign flag (S-flag), 173 

SOUND, 123 

sound generation, 117 
C-64 mode, 118-120 
C-128 mode, 121-122 

spirals, 75 

sprites, 58, 89-98 
collisions, 91 
priorities, 94 

Square waves, 118 

stack, 18-20, 

stack pointer (SP), 165 
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STASH, 9 

subtraction (binary), 170 
8502, 181 

SWAP, 9 

SYS, 4, 8, 156 


timer, 139, 140 
tokens, 6 


User port, 13, 139-144 
USR, 8 


VDC (Video Device Controller), 13, 101-105 
vectors, 8 

version register, 28 

VIC, 13, 51, 57, 85, 101 

video RAM, 11, 57-58, 67-70, 102 

volume, 118 


WAIT, 9 

Wave form generator, 117 
WINDOW, 62 

XOR, 9 


Z-8Q microprocessor, 3, 161-174 
machine language, 187-196 
Zero page, 11, 17, 23 


3-D graphics, 81 

40-column screen, 49-63 

80-column screen, 101-113 

8502 microprocessor, 3, 161-174, 196 
machine languge, 177-183 
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Optional Diskette 


C-128 PEEKS &POKES 
Optional diskette 






For your convenience, the program listings contained in this book are 
available on an 1541 formatted floppy disk. You should order the diskette if 
you want to use the programs, but don't want to type them in from the 
listings in the book. 


All programs on the diskette have been fully tested. You can change the 
programs for your particular needs. The diskette is available for $14.95 plus 
$2.00 ($5.00 foreign) for postage and handling. 


When ordering, please give your name and shipping address. Enclose a 


check, money order or credit card information. Mail your order to: 


Abacus Software 
P.O. Box 7219 
Grand Rapids, MI 49510 


Or for fast service, call (616) 241-5510. 










The complete compiler 
and development pack- 
age. Speed up your pro- 
grams 5x to 35x. Many 
options: flexible memory 
management; choice of 
compiling to machine 
code, compact p-code or 
both. '128 version: 40 or 
80 column monitor output 
and FAST-mode opera- 
tion. ‘128 Compiler's ex- 
tensive 80-page pro- 
grammer's guide covers 
compiler directives and 
options, two levels of 
optimization, memory usage, I/O handling, 80 column hi-res graphics, faster, 
higher precision math functions, speed and space saving tips, more. A great 
package that no software library should be without. 128 Compiler $59.95 
64 Compiler $39.95 


BA Sl C 
Compiler 


Give your BASIC programs the speed 
and performance they deserve 


For school or software 
development. Learn C on 
your Commodore with our in- 
depth tutorial. Compile C pro- 
grams into fast machine 
language. C-128 version has 
added features: Unix™-like 
operating system; 60K RAM 
disk for fast editing and 
compiling Linker combines 
up to 10 modules; Combine 
M/L and C using CALL; 51K 
available for object code; 
Fast loading (8 sec. 1571, 18 sec. 1541); Two standard 1/O librarys plus 
two additional libraries—math functions (sin, cos, sqrt, etc.) & 20+ graphic 
commands (line, fill, dot, etc.). C-128 $59.95 


C-64 $59.95 


Language 
Compiler 


On your 


per 


C:'C- 


The language of the 80's and beyond 











DOMESTIC AUTO SALES Easily create professional 
| ero high quality charts and 
Bp chavs ,; 
Erevenicen rorons graphs without programming. 
You can immediately change 
the scaling, labeling, axis, 
bar filling, etc. to suit your 
needs. Accepts data from 
CalcResult and MultiPlan. 
C-128 version has 3X the 
resolution of the '64 version. 
Outputs to most printers. 
C-128 $39.95 
C-64 $39.95 
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PowerPlan 
One of the most powerful spreadsheets with integrated 
graphics. Includes menu or keyword selections, online help 
screens, field protection, windowing, trig functions and more. 
PowerGraph, the graphics package, is included to create 








integrated graphs and charts. C-64 $39.95 
Technical Analysis System for the C-64 $59.95 
Ada Compiler for the C-64 $39.95 
VideoBasic Language for the C-64 $39.95 


Remarkably easy-to-use 
interactive drawing pack- 
age for accurate graphic 
designs. New dimension- 
ing features to create 
exact Scaled output to all 
major dot-matrix printers. 
Enhanced version allows 
you to input via keyboard 
or high quality lightpen. 
Two graphic screens for 
COP Ying from one to the 
other. DRAW, LINE, BOX, 
CIRCLE, ARC, ELLIPSE 
available. FILL objects 
with preselected PAT- 








TERNS; add TEXT; SAVE and RECALL designs to/from disk. Define your own 
library of symbols/objects with the easy-to-use OBJECT MANAGEMENT 
SYSTEM-store up to 104 separate objects. 


C-128 $59.95 
C-64 $39.95 


Not just a compiler, but a 
complete system for develop- 
ing applications in Pascal 
with graphics and sound 
features. Extensive editor 
with search, replace, auto, 
renumber, etc. Standard J & 
W compiler that generates 
fast machine code. If you 
want to learn Pascal or to 
develop software using the 
best tools available-SUPER 
Pascal is your first choice. 

C-64 $59.95 


Let your ‘128 or ‘64 speak Pascal 


OTHER TITLES AVAILABLE: 


COBOL Compiler 
Now you can learn COBOL, th st widely used commercial 
programing language, and L on your 64. COBOL 
is easy to learn because | read. COBOL Compiler 
package comes complet Editor, Compiler, Interpreter 
and Symbolic Debugger. C-64 $39.95 







Personal Portfolio Manager 
Complete portfolio management system for the individual or 
professional investor. Easily manage your portfolios, obtain 
up-to-the-minute quotes and news, and perform selected 
analysis. Enter quotes manually or automatically through 
Warner Computer Systems. C-64 $39.95 


Xper 

XPER is the first "expert system" for the C-128 and C-64. While 
ordinary data base systems are good for reproducing facts, 
XPER can derive knowledge from a mountain of facts and help 
you make expert decisions. Large capacity. Complete with 
editing and reporting. C-64 $59.95 
C-128 and C-64 are tademarks of Commodore Business Machines Inc 

Unix is a tademark of Bet Laboratories 


Abacusiiiti! Software 


P.O. Box 7219 Dept.M9 Grand Rapids, Ml 49510 - Telex 709-101 - Phone (616) 241-5510 


Call now for the name of your nearest dealer. Or to order directly by credit card, MC, AMEX ( VISA call (616) 
241-5510. Other software and books are available—Call and ask for your free catalog. Add $4.00 for shipping 
per order. Foreign orders add $12.00 per item. Dealer inquires welcome—1400+ nationwide. 
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Abacus BERR Software Abacus REE Software Abacus EEL Software Abacus BRET Software Abacus BERR Software 


-efaied guide presents the 128's Get all the inside information on Filled with info for everyone. Covers Insiders’ guide for novice & ad- Learn fundamentals of CAD while 
operating system, explains graphic BASIC 70 This exhaustive hand- 80 column ht-res graphics, win- vanced users Covers sequential & developing your own system. Design 
hips, Memory Management Unt, 80 book is complete with commented dowing, memory layout, Kernal relative files, & direct access com- objects on your screen to dump to a 
solumn graphics and commented BASIC 7.0 ROM listings. Coming routines, sprites, software pro- mands Describes DOS routines printer Includes listings for ‘64 with 
ROM uetings S500pp $1995 Summer '86 $1995 tection, autostarting. 300pp $1995 Commented listings $1995 Simon's Basic Opp $1995 
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Abacus BER Software Abacus FR Software Abacus BREE Software 


“troduction to programing, problem Presents dozens of programming Essential quide for everyone inter- 
onalysis, thorough description of all quick-hitters. Easy and useful ested in CP/M on the 128. Simple 
ASiC commands with hundreds of | techniques on the operating system, explanation of the operating system, 
examples, monitor commands: util Stacks, Zero-page, pointers, the memory usage, CP/M utility pro- 
hes much more $1695 BASIC interpreter and more $1695 grams, submit files & more $1995 





ANATOMY OF C-64 Insider's guide to the = TRICKS & TIPS FOR C-64 Collection of SCIENCE/ENGINEERING ON C-64 In Adventure 


6&4 internals. Graphics, sound, VO, kernal, Samews iter: Handocos 


HW) Hameo no Comomecommented easy-to-use techniques: advanced graphics, depth intro to computers in science. Topics: Step-by-step guide to designing and writing 
rican sogsn Sos improved data input, enhanced BASIC, chemistry, physics, biology, astronomy, your own adventure games. With automated 
: ngs. pp . CP/M, more. 275pp $19.95 electronics, others. 350pp $19.95 adventure game generator. 200pp $14.95 
ANATOMY OF 1 a ORIVE Best 1541 REPAIR & MAINTENANCE CASSETTE BOOK C-64/VIC-20  peEeKs & POKES FOR THE C-64 
sandbook on terns s all. Many Wandbook describes the disk drive hard- Comprehensive guide; many sample Includes in-depth explanations of PEEK 
examples and commented ware. Includes schematics and techniques programs. High speed operating system POKE. USR, and other BASIC cannhiande: 
‘541 ROM snd ae S00pp $19.95 I keep 1541 running. 200pp $19.95 fast file loading and saving. 225pp $14.95 Learn the "inside" tricks 10 get the most a 
“AA CHINE LANGUAGE C-64 Learn p~DpvANCED MACHINE LANGUAGE IDEAS FOR USE ON C-64 Themes: of your ‘64. 200pp $14.95 
>‘) code write fast programs. Many sam- Not covered elsewhere: - video controller, | auto expenses, Calculator, recipe file, stock Optional Diskettes for books 
» 48 and hstings for complete assembler, interrupts, timers, clocks, VO, real time, lists, diet planner, window advertising, For: your. convenience. the -proarame 
-onitor, & simulator. 200pp $14.95 gxtended BASIC, more. 210pp $14.95 others. Includes Itstings. 200pp $12.95 eonlainad: \hreach 6} air books pees 
GRAPHICS BOOK C-64 - best reference panteR BOOK C-64/VIC-20 Under, COMPILER BOOK C-64/C-128 All you able on diskette to save you time entering 
covers basic and advanced graphics. .4.4 Commodore. Epson-compatible print- need to know about compilers: how they them from your keyboard. Specify name of 
oprites, animation, Hires, Multicolor, op. ang 1520 plotter. Packed: utilities; gra- work; designing and writing your Own; book when ordering. $14.95 each 
ghtpen, 3D-graphics, IRQ, CAD, pro- phics dump; 3D-plot; commented MPS801 generating machine code. With working 
“sCUONS, Curves, more. 350pp $19.95 Roy listings: pares , 330pp $19.95 example compiler. 300pp $19.95 


C-128 and C-64 ave trademarks of Commodore Business Machines Inc 


Abacus lili! Software 


P.O. Box 7219 Dept.M9 Grand Rapids, MI 49510 - Telex 709-101 - Phone (616) 241-5510 


Optional diskettes available for all book titles - $14.95 each. Other books & software also available. Call for the name of your 
nearest dealer. Or order directly from ABACUS using your MC, Visa or Amex card. Add $4.00 per order for shipping. Foreign 
arders add 410.00 per book. Call now or write for your free catalog. Dealer inquires welcome--over 1400 dealers nationwide. 
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MACHINE LANGUAGE 
Program in the fastest 
language for your Atari 
ST. Learn the 68000 
assembly language, its 
numbering system, use 
of registers, the structure 
& important details of the 
instruction set, and use of 
the internal system 
routines. 280pp $19.95 





Becker book published by 






Essential guide to learning 
the inside information on the 
ATARI ST. Written for the 
user who wants thorough 
and complete descriptions of 
the inner workings of the ST. 
Detailed descriptions of the 
sound and graphics chips, 
the internal hardware, the 
Centronics and RS-232 
ports, GEM, important system 
addresses and plenty more. 
Also included is a complete 
documented BIOS assembly 
listing. This indispensible 
reference is a_ required 
addition to your ATARI ST 
library. 450 pages. $19.95 


TRICKS & TIPS 
Treasure trove of fascin- 
ating tips and tricks 
allows you to make full 
use of your ATARI ST. 
Fantastic graphics, refin- 
ing programs in BASIC, 
assembler, and C. 
Includes program listings 
for RAM disk, printer 
spooler and more. $19.95 


Abacus 


GRAPHICS & SOUND 
A comprehensive hand- 
boek showing you how to 
create fascinating graph- 
ics and suprising music 
and sound from the 
ATARI ST. See and hear 
what sights and sounas 
that you're capable of 
producing from your 
ATARI ST. $19.95 
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GEM Programmers’ Reference 


A complete gulde to 
programming the ST 
using the Graphics 







LOGO 
Take contro! of your 
ATAR! ST by—learning 
LOGO-the easy-to-use, 
yet powerful language. 
Topics covered include 
structured programming, 
graphic movement, file 
handling and more. An 
excellent book for kids as 
well as adults. $19.95 
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For the serious programmer 
in need of detailed inform- 
ation on the GEM operating 
system. Written especially for 
the Atari ST with an easy-to- 
understand format that even 
beginners will be able to 
follow. All GEM routines and 
examples are written in C 
and 68000 assembly 
language. Covers working 
with the mouse, icons, Virtual 
Device Interface (VDI), 
Application Environment 
Services (AES) and the 
Graphics Device Operating 
System. Required reading for 
the seriouS programmer 
intrested in understanding 
the ST. 450 pages. $19.95 
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PEEKS & POKES 
Enhance your programs 
with the examples found 
within this book. Explores 
using the different lang- 
uages BASIC, C, LOGO 
and machine language, 
using various interfaces, 
memory usage, reading 
and saving trom and to 
disk, More. $19.95 


PRESENTING THE ST 
Gives you an in-depth 
look at this sensational 
new computer. Discusses 
the architecture of the 
ST, working with GEM, 
the mouse, operating 
system, all the various 
interfaces, the 68000 
chip and its instructions, 
LOGO. $16.95 
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P.O. Box 7219 Grand Rapids, Ml 49510 - Telex 709-101 - Phone (616) 241-5510 


Optional diskettes are available for all book titles at $14.95 
Call now for the name of your nearest dealer. Or order directly from ABACUS with your MasterCard, VISA, or 
Amex card. Add $4.00 per order for postage and handling. Foreign add $10.00 per book. Other software and 
books coming soon. Call or write for free catalog. Dealer inquiries welcome—over 1200 dealers nationwide. 
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DUCTIVITY 


New ST software from a name you can count on... 


PCBoard 
Designer 


Create printed circuit board layouts 








Features: Auto-routing, component 
list, pinout list, net list 





PCBoard Designer 
Interactive, computer-aided design 
package that automates layout of 
printed circuit boards. Auto-routing 
with 45° or 90° traces; two-sided 
boards; pin-to-pin, pin-to-BUS or BUS- 
to-BUS. Rubberbanding of components 
during placement. Prints board layout, 
pinout. component list, net list. Output 
to Epson printer at 2:1. Pays for itself 
after first designed board. $395.00 
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PaintPro _, 
PaintPro 


For creative illustrations on the S 


beast EF 


Word processor for the ST 











ST TextPro 
Wordprocessor with professional 
features and easy-to-use! Full-screen 
editing with mouse or keyboard 
shortcuts. High speed input, scrolling 
and editing; sideways printing; 
multi-column output; flexible printer 
installation; automatic index and table 
of contents; up to 180 chars/line; 30 
definable function keys; metafiie 
output; much more. $49.95 
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windows 












with your text 


Combine graphics 
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FilePro 


Ere. The electronic 
peel filing system 





ST FilePro 
A simple-to-use and versatile database 
manager. Features help screens; 
lightning-fast operation; tailorable 
display using multiple fonts; 
user-definable edit masks; capacity up 
to 64,000 records. Supports multiple 
files. RAM-disk support for 1040ST. 
Complete search, sort and file 
subseiting. interfaces io TexiPro. Easy 
printer control. $49.95 


AssemPro 


The complete 68000 
assembler development 


package for the ST 





ST Forth/MT 
Powerful, multi-tasking Forth for 
the ST. A complete, 32-bit imple- 
mentation based on Forth-83 
standard. Development aids: full 
screen editor, monitor, macro 
assembler. 1500+ word library. 
TOS/LINEA commands. Floating 
point and complex arithmetic. 
Available Sept. ‘86. $49.95 


ST PalntPro 

A GEM™ among ST drawing 
programs. Very friendly, but very 
powerful. A must for everyone's 
artistic or graphics needs. Use 
up to three windows. Free-form 
sketching; lines, circles, ellipses, 
boxes, text, fill, copy, move, 
zoom, spray, paint, erase, undo, 

$49.95 


ST Text Designer 
An ideal package for page layout 
on the ST. Accepts prepared text 
files from TextPro or other ASCII 
wordprocessors. Performs block 
operations— copy, move, col- 
umns. Merges. bit-mapped 
graphics. Tools to add borders & 
separator lines, more. Available 
September ‘86. $49.95 


ST AssemPro 
Professional developer's pack- 
age includes editor, two-pass 
interactive assembler with error 
locator, online help including 
instruction address mode and 
GEM parameter information, 
monitor-debugger, disassembler 
and 68020 simulator, more. 
Available Sept. '86. $59.95 
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Call now for the name of your nearest dealer. Or order directly from ABACUS with your MasterCard, VISA, or Amex card. Add 
$4.00 per order for postage and handling. Foreign add $10.00 per item. Other software and books coming soon. Call or 
write for your free catalog. Dealer inquiries welcome-over 1400 dealers nationwide. 





COMMODORE’ 


Unlock the secrets 
of the C-128 











PRS B PUSS 


Peeks & Pokes clearly explains the procedures involved in exploring 
the C-128's operating system. Includes a large number of important 
POKEs and their uses as well as a first-class explanation of the 
C-128's internal design. Some of the topics discussed are: 


How a computer works ¢ The operating system 

How the interpreter works ¢ RAM expansion commands 
Bank switching e Zero page 

Pointer and stack ¢ Memory map 

Mass storage and peripherals ¢« The 40/80 column screens 
The basis of machine janguage:* ¢ 640 x 200 hires graphics 
Tone generation The keyboard 

The user port ¢e BASIC and operating system 
8502 & Z-80 machine language 


About the authors: 

Hans Joachim Liesert, student at RWTH, Aachen, Germany, has been 
involved with computers for many years and is the author of the book 
Peeks & Pokes for the Commodore 64. Rudiger Linden is also a 
student at RWTH, studying industrial machine design, and is best 
Known for an European book on computer games. 
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